cicora.ai
Προδιαγραφή APIΈξοδος ασφαλής ως προς το σχήμα

Δομημένες έξοδοι

Ζητήστε αντικείμενο JSON ή JSON Schema όταν την απάντηση θα καταναλώσει λογισμικό και όχι άνθρωπος.

Αναφορά ενσωμάτωσης: επιλέξτε παραμέτρους και διαθέσιμες δυνατότητες από τις ρυθμίσεις API του λογαριασμού σας και τον κατάλογο μοντέλων για το περιβάλλον σας.

Ορίστε response_format

Η λειτουργία JSON είναι χρήσιμη για ένα απλό αντικείμενο. Το JSON Schema προσθέτει όνομα σχήματος, δομή πεδίων, απαιτούμενες ιδιότητες και τρόπο απόρριψης πρόσθετων ιδιοτήτων.

Ένα αυστηρό σχήμα μειώνει την αμυντική ανάλυση, αλλά δεν αντικαθιστά ποτέ την επικύρωση στην πλευρά της εφαρμογής.

Μορφή απάντησης 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
      }
    }
  }
}

Σχεδιάστε το σχήμα

  • Διατηρήστε τα πεδία και τις περιγραφές σύντομα και ειδικά για τον τομέα.
  • Ορίστε additionalProperties: false όπου δεν είναι αποδεκτά άγνωστα πεδία.
  • Δώστε εκδόσεις στα σχήματα στον δικό σας κώδικα, αντί να αλλάζετε αόρατα μια σύμβαση καταναλωτή.

Χειριστείτε το αποτέλεσμα

Επικυρώστε το επιστρεφόμενο JSON με τον ίδιο επικυρωτή που χρησιμοποιεί το API ή η βάση δεδομένων σας.

Αν ένα μοντέλο ή μια διαδρομή δεν δέχεται τη ζητούμενη μορφή, εμφανίστε ελεγχόμενο σφάλμα και επιλέξτε μια συμβατή εναλλακτική μέσω του καταλόγου μοντέλων.