Nachricht zusammenstellen
Eine Anfrage enthält model, messages und max_tokens; die Systemanweisung wird in einem getrennten Feld system gesendet. Bewahren Sie Rollen und Nachrichtenreihenfolge auf, damit eine Wiederholung den Kontext reproduzieren kann.
Direkte HTTP-Aufrufe gehen an https://cicora.ai/api/v1/messages, während ein Messages SDK nur das Gateway-Stammverzeichnis https://cicora.ai/api erhält und /v1/messages selbst anhängt.
Messages-API-Anfrage
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 und Streaming
- Fügen Sie tools und tool_choice nur bei Modellen hinzu, die sie unterstützen.
- Verarbeiten Sie den Streaming-Modus als Ereignisfolge statt als einzelnes JSON-Objekt.
- Bestätigen Sie die Struktur der Tool-Argumente, bevor Sie eine Aktion ausführen.
Format auswählen
Mischen Sie keine Felder aus zwei Formaten in einer Anfrage. Wählen Sie an der Client-Grenze Chat oder Messages und normalisieren Sie den internen Verlauf einmal.
Testen Sie eine Migration mit einer gespeicherten deidentifizierten Unterhaltung, einschliesslich eines Tool-Ergebnisses und langen Kontexts.