Ottili AI API — Strukturierte Ausgaben

Die Ottili AI API kann Antworten an ein JSON-Schema binden, sodass Sie parsebare Daten statt Freitext erhalten. Nicht jedes Modell unterstützt strukturierte Ausgaben — prüfen Sie zuerst die capabilities des Modells.

Anfrage

{
  "model": "auto",
  "messages": [{ "role": "user", "content": "Extrahiere Kundenname und Bestellsumme." }],
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "order_summary",
      "schema": {
        "type": "object",
        "properties": {
          "customer_name": { "type": "string" },
          "order_total": { "type": "number" }
        },
        "required": ["customer_name", "order_total"],
        "additionalProperties": false
      }
    }
  }
}

Antwort

Der Assistenten-Content ist gültiges JSON, das zum Schema passt:

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "{\"customer_name\":\"Acme GmbH\",\"order_total\":1299.0}"
      },
      "finish_reason": "stop"
    }
  ]
}

Hinweise

• Das Schema muss ein gültiges JSON-Schema-Objekt sein; nicht unterstützte Keywords liefern VALIDATION_ERROR (HTTP 422).
• Streaming ist mit strukturierten Ausgaben kompatibel; das finale Event trägt das vollständige Objekt.
• Wirbt das gewählte Modell nicht structured_outputs in seinen Capabilities, gibt die API einen klaren Capability-Fehler zurück, anstatt eine ungebundene Antwort zu liefern.