Redacta un mensaje
Una solicitud contiene model, messages y max_tokens; la instrucción system se envía en un campo system separado. Conserva los roles y el orden de los mensajes para que un reintento pueda reproducir el contexto.
Las llamadas HTTP directas usan https://cicora.ai/api/v1/messages, mientras que un SDK de Messages recibe solo la raíz de la pasarela https://cicora.ai/api y añade /v1/messages por sí mismo.
Solicitud de la 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."}]
}'Herramientas y streaming
- Añade tools y tool_choice solo para modelos compatibles.
- Gestiona el streaming como secuencia de eventos y no como un único objeto JSON.
- Confirma la estructura de los argumentos de la herramienta antes de realizar una acción.
Elige un formato
No mezcles campos de dos formatos en una solicitud. Elige chat o messages en el límite del cliente y normaliza una sola vez el historial interno.
Prueba la migración con una conversación guardada y sin datos identificativos, incluido un resultado de herramienta y contexto largo.