Output terstruktur

Tetapkan response_format

Mode JSON berguna untuk objek sederhana. JSON Schema menambahkan nama skema, struktur kolom, properti wajib, dan cara menolak properti tambahan.

Skema ketat mengurangi parsing defensif, tetapi tidak pernah menggantikan validasi di sisi aplikasi.

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

Rancang skema

• Buat kolom dan deskripsi tetap ringkas serta spesifik untuk domain.
• Tetapkan additionalProperties: false jika kolom yang tidak dikenal tidak dapat diterima.
• Beri versi pada skema dalam kode Anda sendiri, alih-alih diam-diam mengubah kontrak yang diandalkan kode konsumen.

Tangani hasil

Validasi JSON yang dikembalikan dengan validator yang sama dengan yang digunakan API atau basis data Anda.

Jika model atau rute tidak menerima format yang diminta, tampilkan kesalahan terkendali dan pilih opsi kompatibel melalui katalog model.