1. Preparar o ambiente
Guarde a chave apenas numa variável de ambiente ou num cofre de segredos. O código do navegador não pode contê-la nem escrevê-la em registos.
O URL base da integração é https://cicora.ai/api/v1. Cada exemplo abaixo acrescenta a sua rota a essa 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. Compor o pedido
- Use o identificador exato do modelo devolvido pelo catálogo.
- Envie as mensagens por ordem de conversa: system, user, assistant e tool quando necessário.
- Comece com menor variação e depois ajuste os parâmetros à tarefa.
3. Tratar a resposta
Leia o texto do primeiro item de resposta disponível e guarde o ID do pedido juntamente com o seu próprio ID de rastreio.
Verifique a estrutura do estado e do erro antes de repetir. Repita apenas operações nas quais a aplicação consiga impedir trabalho duplicado.