Introdução

Bem-vindo à documentação oficial da Cico AI. Nossa API oferece uma suíte completa de modelos de inteligência artificial (Texto, Visão e Imagens), operando com 100% de compatibilidade com o formato da OpenAI.

Base URL: https://ia.cico.site/v1

Mude apenas a Base URL e a chave da API em seu projeto ou ferramentas como Cursor e o código continuará funcionando perfeitamente usando nossas IAs mais baratas.

Autenticação

Todas as requisições para a API devem ser autenticadas usando o cabeçalho Authorization: Bearer. Você recebe este token ao criar sua conta na plataforma.

Header Example
Authorization: Bearer cico-key-dev-123

Modelos Disponíveis

Escolha o modelo ideal passando o ID do Modelo no campo model da requisição JSON:

ID do Modelo Nome Custo (1M Tokens) Especialidade
hermes Hermes R$ 0,40 / R$ 1,50 Velocidade. Ideal para chatbots em tempo real e respostas curtas/médias.
atenas Atenas R$ 0,50 / R$ 2,00 Raciocínio. Otimizado para lógica complexa, codificação e análise profunda.
apollo Apollo R$ 1,00 / R$ 3,40 Visão. Capaz de analisar imagens, ler documentos (OCR) e interpretar interfaces.
hefesto Hefesto R$ 2,00 / R$ 5,00 Criação. Gera imagens artísticas a partir de descrições textuais.

* Custos referentes a Input e Output respectivamente.

Chat Completions (OpenAI Format)

Este é o endpoint unificado para interação com todos os modelos (Texto, Visão e Imagem) usando o formato da OpenAI.

Endpoint Definition
POST /v1/chat/completions

Request Body (JSON)

Campo Tipo Obrigatório Descrição
model string Sim O ID do modelo (Ex: hermes, apollo).
messages array Sim Lista de mensagens (Ex: {"role": "user", "content": "Olá!"}).

Multimodalidade & Visão (Apollo)

Para enviar imagens em Base64, utilize a estrutura visual da OpenAI em sua mensagem de usuário.

Exemplo de Payload com Imagem (JSON)
{
  "model": "apollo",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Descreva esta imagem" },
        { "type": "image_url", "image_url": { "url": "data:image/jpeg;base64,/9j/4AAQSk..." } }
      ]
    }
  ]
}

Response Body (JSON)

A API retorna um objeto JSON compatível com OpenAI, contendo informações e campos extras customizados para acompanhamento de gastos na plataforma.

Campo Retornado Localização no JSON Descrição
content choices[0].message.content O texto de resposta da IA.
total_tokens usage.total_tokens O total de tokens (Input + Output) consumidos.
cost_brl (Extensão Cico) root.cost_brl Custo desta requisição já em Reais (R$).
generated_image (Extensão Cico) root.generated_image Se usar o modelo Hefesto, a imagem criada vem em formato Base64 aqui.

Códigos de Erro

Código Significado
200 Sucesso. Resposta gerada.
400 Parâmetros inválidos (falta model ou messages).
401 Token de autorização inválido ou ausente.
402 Saldo insuficiente na conta.
404 Modelo não encontrado (Verifique o slug do modelo).
502 Erro de comunicação com o cluster interno da IA.

Gerador de SDK e Código

Configure sua requisição abaixo e obtenha o código pronto usando bibliotecas oficiais, assim como faria com o ChatGPT.

Nenhuma mensagem anterior no histórico.
# O código aparecerá aqui...