cicora.ai
Spesifikasi APIOutput selamat skema

Output berstruktur

Minta objek JSON atau JSON Schema apabila perisian, bukannya manusia, akan menggunakan respons.

Rujukan penyepaduan: pilih parameter dan keupayaan yang tersedia daripada tetapan API akaun serta katalog model untuk persekitaran anda.

Tetapkan response_format

Mod JSON berguna untuk objek ringkas. JSON Schema menambah nama skema, struktur medan, sifat yang diperlukan dan cara untuk menolak sifat tambahan.

Skema ketat mengurangkan keperluan penghuraian defensif, tetapi tidak pernah menggantikan pengesahan pada pihak aplikasi.

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

Reka bentuk skema

  • Pastikan medan dan perihalan ringkas serta khusus untuk domain.
  • Tetapkan additionalProperties: false apabila medan yang tidak diketahui tidak boleh diterima.
  • Berikan versi kepada skema dalam kod anda sendiri dan bukannya mengubah kontrak pengguna secara tidak kelihatan.

Kendalikan hasil

Sahkan JSON yang dikembalikan dengan pengesah sama yang digunakan oleh API atau pangkalan data anda.

Jika model atau laluan tidak menerima format yang diminta, paparkan ralat terkawal dan pilih pilihan serasi melalui katalog model.