Compor uma mensagem
Um pedido contém model, messages e max_tokens; a instrução de sistema é enviada num campo system separado. Preserve as funções e a ordem das mensagens, para que uma nova tentativa possa reproduzir o contexto.
As chamadas HTTP diretas usam https://cicora.ai/api/v1/messages, enquanto um SDK Messages recebe apenas a raiz do gateway https://cicora.ai/api e acrescenta ele próprio /v1/messages.
Pedido da 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."}]
}'Ferramentas e transmissão
- Acrescente tools e tool_choice apenas para modelos que os suportem.
- Trate o modo de transmissão como uma sequência de eventos, e não como um único objeto JSON.
- Confirme a estrutura dos argumentos da ferramenta antes de executar uma ação.
Escolher um formato
Não misture campos de dois formatos num pedido. Escolha chat ou messages no limite do cliente e normalize uma só vez o histórico interno.
Teste a migração com uma conversa guardada e sem elementos identificativos, incluindo um resultado de ferramenta e contexto longo.