cicora.ai
API-specifikationOutput som følger skemaet

Strukturerede output

Anmod om et JSON-objekt eller JSON Schema når svaret skal bruges af software, ikke af en person.

Integrationsreference: Vælg parametre og tilgængelige funktioner fra API-indstillingerne for kontoen og modelkataloget for dit miljø.

Angiv response_format

JSON-tilstand er nyttig til et enkelt objekt. JSON Schema tilføjer et skemanavn, feltstruktur, obligatoriske egenskaber og en måde at afvise ekstra egenskaber på.

Et strengt skema reducerer behovet for defensiv analyse, men erstatter aldrig validering på applikationssiden.

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

Udform skemaet

  • Hold felter og beskrivelser korte og domænespecifikke.
  • Angiv additionalProperties: false, hvor ukendte felter ikke er tilladt.
  • Versionér skemaer i din egen kode i stedet for at ændre en forbrugerkontrakt usynligt.

Behandl resultatet

Validér returneret JSON med den samme validator, som dit API eller din database bruger.

Hvis en model eller rute ikke accepterer det forespurgte format, viser du en kontrolleret fejl og vælger et kompatibelt alternativ gennem modelkataloget.