cicora.ai
Προδιαγραφή APIΜορφή Messages

Messages API

Χρησιμοποιήστε τη μορφή Messages για συνομιλίες με οδηγία συστήματος ανώτατου επιπέδου και ρητό όριο εξόδου.

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

Συνθέστε μήνυμα

Ένα αίτημα περιέχει model, messages και max_tokens· η οδηγία συστήματος αποστέλλεται σε ξεχωριστό πεδίο system. Διατηρήστε τους ρόλους και τη σειρά μηνυμάτων, ώστε μια επανάληψη να μπορεί να αναπαραγάγει το πλαίσιο.

Οι ανεπεξέργαστες κλήσεις HTTP χρησιμοποιούν https://cicora.ai/api/v1/messages, ενώ ένα SDK Messages λαμβάνει μόνο τη ρίζα πύλης https://cicora.ai/api και προσθέτει μόνο του /v1/messages.

Αίτημα Messages API
bash
curl --request POST https://cicora.ai/api/v1/messages \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "anthropic/claude-sonnet-5",
    "max_tokens": 500,
    "system": "Answer with a compact checklist.",
    "messages": [{"role": "user", "content": "Prepare a release plan."}]
  }'

Εργαλεία και ροή

  • Προσθέστε tools και tool_choice μόνο για μοντέλα που τα υποστηρίζουν.
  • Χειριστείτε τη λειτουργία ροής ως ακολουθία συμβάντων και όχι ως ένα αντικείμενο JSON.
  • Επιβεβαιώστε τη μορφή των ορισμάτων του εργαλείου πριν εκτελέσετε μια ενέργεια.

Επιλέξτε μορφή

Μην αναμειγνύετε πεδία δύο μορφών σε ένα αίτημα. Επιλέξτε chat ή messages στο όριο του πελάτη και κανονικοποιήστε το εσωτερικό ιστορικό μία φορά.

Δοκιμάστε τη μετάβαση με αποθηκευμένη αποταυτοποιημένη συνομιλία, που περιλαμβάνει αποτέλεσμα εργαλείου και μεγάλο πλαίσιο.