Een bericht samenstellen
Een aanvraag bevat model, messages en max_tokens; de systeeminstructie wordt in een afzonderlijk system-veld verzonden. Behoud rollen en berichtvolgorde, zodat een nieuwe poging de context kan reproduceren.
Ruwe HTTP-aanroepen gebruiken https://cicora.ai/api/v1/messages, terwijl een Messages SDK alleen de gateway-root https://cicora.ai/api ontvangt en zelf /v1/messages toevoegt.
Messages API-aanvraag
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 en streaming
- Voeg tools en tool_choice alleen toe voor modellen die ze ondersteunen.
- Verwerk de streamingmodus als een reeks gebeurtenissen in plaats van één JSON-object.
- Bevestig de vorm van toolargumenten voordat u een actie uitvoert.
Een indeling kiezen
Meng geen velden uit twee indelingen in één aanvraag. Kies chat of messages aan de clientgrens en normaliseer de interne geschiedenis één keer.
Test migratie met een opgeslagen, gedeïdentificeerd gesprek, inclusief een toolresultaat en lange context.