Componi un messaggio
Una richiesta contiene model, messages e max_tokens; l'istruzione di sistema viene inviata in un campo system separato. Conserva ruoli e ordine dei messaggi affinché un nuovo tentativo possa riprodurre il contesto.
Le chiamate HTTP dirette usano https://cicora.ai/api/v1/messages, mentre un SDK Messages riceve solo la radice del gateway https://cicora.ai/api e aggiunge autonomamente /v1/messages.
Richiesta 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."}]
}'Strumenti e streaming
- Aggiungi tools e tool_choice solo per i modelli che li supportano.
- Gestisci la modalità streaming come una sequenza di eventi, non come un singolo oggetto JSON.
- Conferma la struttura degli argomenti dello strumento prima di eseguire un'azione.
Scegli un formato
Non combinare in una sola richiesta campi provenienti da due formati. Scegli chat o messages al confine del client e normalizza una sola volta la cronologia interna.
Prova la migrazione con una conversazione salvata e deidentificata, che includa il risultato di uno strumento e un contesto lungo.