cicora.ai
API-spesifikasjonUtdata som følger skjemaet

Strukturerte utdata

Be om et JSON-objekt eller JSON Schema når svaret skal brukes av programvare, ikke av en person.

Integrasjonsreferanse: Velg parametere og tilgjengelige funksjoner fra API-innstillingene for kontoen og modellkatalogen for miljøet ditt.

Angi response_format

JSON-modus er nyttig for et enkelt objekt. JSON Schema legger til et skjemanavn, feltstruktur, obligatoriske egenskaper og en måte å avvise ekstra egenskaper på.

Et strengt skjema reduserer behovet for defensiv analyse, men erstatter aldri validering på applikasjonssiden.

Svarformat 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
      }
    }
  }
}

Utform skjemaet

  • Hold felt og beskrivelser konsise og domenespesifikke.
  • Angi additionalProperties: false der ukjente felt ikke er tillatt.
  • Versjoner skjemaer i din egen kode i stedet for å endre en kontrakt som mottakende systemer er avhengige av, uten at det merkes.

Behandle resultatet

Valider returnert JSON med den samme validatoren som API-et eller databasen din bruker.

Hvis en modell eller rute ikke godtar det forespurte formatet, viser du en kontrollert feil og velger et kompatibelt alternativ gjennom modellkatalogen.