1. Préparer l’environnement
Conservez la clé uniquement dans une variable d’environnement ou un stockage de secrets. Le code du navigateur ne doit ni la contenir ni l’écrire dans les journaux.
L’URL de base de l’intégration est https://cicora.ai/api/v1. Chaque exemple ci-dessous ajoute sa route à cette base.
export CICORA_API_KEY=replace_with_your_key
curl --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "openai/gpt-5.6-sol",
"messages": [{"role": "user", "content": "Explain this API in one sentence."}]
}'2. Composer la requête
- Utilisez l’identifiant exact du modèle renvoyé par le catalogue.
- Envoyez les messages dans l’ordre de la conversation : system, user, assistant et tool, lorsque nécessaire.
- Commencez par une variabilité faible, puis ajustez les paramètres à la tâche.
3. Traiter la réponse
Lisez le texte du premier élément de réponse disponible et enregistrez l’ID de requête avec votre propre ID de trace.
Vérifiez le statut et la structure de l’erreur avant de réessayer. Ne relancez que les opérations pour lesquelles votre application peut empêcher le travail en double.