cicora.ai
Especificação da APIRespostas

Perguntas frequentes para programadores

Respostas práticas e breves sobre chaves, URLs base, modelos, custos e diagnóstico de integrações.

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.

Por onde devo começar?

Crie uma chave separada, configure o URL base de estilo OpenAI https://cicora.ai/api/v1, e execute GET /models. Depois envie um pedido de chat mínimo com um identificador de modelo selecionado.

Para um SDK Messages, use a raiz do gateway https://cicora.ai/api. Perante um 404, compare o URL final com o protocolo do cliente: um acrescenta uma rota após /v1, o outro acrescenta /v1/messages.

Um primeiro pedido de diagnóstico seguro
bash
curl --include --request GET https://cicora.ai/api/v1/models \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Accept: application/json'

Soluções frequentes

  • Não guarde uma chave no código do cliente nem a publique num problema ou captura de ecrã.
  • Não considere um exemplo de preço como preço atual: leia o catálogo e os metadados da resposta.
  • Não transfira parâmetros ou capacidades entre modelos sem verificar o modelo.

Quando for necessário apoio

Recolha o carimbo de data e hora, o método, o URL sem segredos na consulta, o estado HTTP, o ID do pedido e um corpo de erro sem elementos identificativos.

Não anexe uma chave, pedidos completos com dados restritos ou ficheiros, salvo quando forem necessários para reproduzir o problema.