Composer un message
Une requête contient model, messages et max_tokens ; l’instruction système est envoyée dans un champ system distinct. Préservez les rôles et l’ordre des messages afin qu’une nouvelle tentative puisse reproduire le contexte.
Les appels HTTP bruts utilisent https://cicora.ai/api/v1/messages, tandis qu’un SDK Messages reçoit uniquement la racine de la passerelle https://cicora.ai/api et ajoute lui-même /v1/messages.
Requête de l’API Messages
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."}]
}'Outils et diffusion continue
- Ajoutez tools et tool_choice uniquement pour les modèles qui les prennent en charge.
- Traitez le mode de diffusion continue comme une séquence d’événements plutôt que comme un seul objet JSON.
- Confirmez la structure des arguments de l’outil avant d’effectuer une action.
Choisir un format
Ne mélangez pas les champs de deux formats dans une même requête. Choisissez chat ou messages à la frontière du client et normalisez une seule fois l’historique interne.
Testez la migration avec une conversation enregistrée et désidentifiée, comprenant un résultat d’outil et un contexte long.