cicora.ai
Specifikacija API-jaIzhod, skladen s shemo

Strukturirani izhodi

Zahtevajte predmet JSON ali JSON Schema, kadar bo odgovor uporabila programska oprema in ne oseba.

Referenčna dokumentacija za integracijo: parametre in razpoložljive zmožnosti izberite v nastavitvah API-ja svojega računa in v katalogu modelov za svoje okolje.

Nastavite response_format

Način JSON je uporaben za preprost predmet. JSON Schema doda ime sheme, strukturo polj, obvezne lastnosti in način zavrnitve dodatnih lastnosti.

Stroga shema zmanjša potrebo po obrambnem razčlenjevanju, vendar nikoli ne nadomesti preverjanja na strani aplikacije.

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

Oblikujte shemo

  • Polja in opisi naj bodo jedrnati ter prilagojeni področju.
  • Nastavite additionalProperties: false, kadar neznana polja niso sprejemljiva.
  • Različice shem vodite v lastni kodi, namesto da neopazno spremenite pogodbo porabnika.

Obdelajte rezultat

Vrnjeni JSON preverite z istim preverjevalnikom, ki ga uporablja vaš API ali zbirka podatkov.

Če model ali pot ne sprejema zahtevane oblike, prikažite nadzorovano napako in prek kataloga modelov izberite združljivo možnost.