cicora.ai
API-specifikationSchemaenlig utdata

Strukturerad utdata

Begär ett JSON-objekt eller JSON Schema när svaret ska användas av programvara i stället för av en person.

Integrationsreferens: välj parametrar och tillgängliga funktioner från API-inställningarna för ditt konto och modellkatalogen för din miljö.

Ange response_format

JSON-läge är användbart för ett enkelt objekt. JSON Schema lägger till ett schemanamn, fältstruktur, obligatoriska egenskaper och ett sätt att avvisa extra egenskaper.

Ett strikt schema minskar behovet av defensiv tolkning, men ersätter aldrig validering på applikationssidan.

Svarsformat med JSON Schema
json
{
  "model": "openai/gpt-5.6-sol",
  "messages": [{"role": "user", "content": "Extract an order summary."}],
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "order_summary",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {"items": {"type": "array"}, "total": {"type": "number"}},
        "required": ["items", "total"],
        "additionalProperties": false
      }
    }
  }
}

Utforma schemat

  • Håll fält och beskrivningar kortfattade och domänspecifika.
  • Ange additionalProperties: false när okända fält inte är tillåtna.
  • Versionshantera scheman i din egen kod i stället för att osynligt ändra ett kontrakt som mottagande system förlitar sig på.

Hantera resultatet

Validera returnerad JSON med samma validerare som används av ditt API eller din databas.

Om en modell eller rutt inte accepterar det begärda formatet visar du ett kontrollerat fel och väljer ett kompatibelt alternativ genom modellkatalogen.