cicora.ai
Especificação da APIComeçar

Início rápido

Envie um primeiro pedido, selecione um modelo no catálogo e conserve um identificador do pedido para diagnóstico.

SDK de estilo OpenAI e curlhttps://cicora.ai/api/v1
SDK Messages e Claude Codehttps://cicora.ai/api

Referência de integração: escolha os parâmetros e as capacidades disponíveis nas definições da API da sua conta e no catálogo de modelos do seu ambiente.

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.

Primeiro pedido
bash
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.