Introdução

Bem-vindo à documentação oficial da Cico AI. Nossa API oferece uma suíte completa de modelos de inteligência artificial, desde processamento de texto ultrarrápido até visão computacional e geração de imagens artísticas.

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

Autenticação

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

Header Example
X-Auth-Token: cico-key-dev-123

Modelos Disponíveis

Escolha o modelo ideal para sua necessidade específica:

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 & Criação

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

Endpoint Definition
POST /models/{model}

Request Body (JSON)

Nossos modelos suportam entrada multimodal. O limite é de 1 arquivo por requisição.

Campo Tipo Obrigatório Descrição
message string Sim A mensagem do usuário ou prompt para geração de imagem.
history array Não Lista de mensagens anteriores para manter o contexto (Chat).
file_base64 string Não Conteúdo do arquivo (Imagem ou PDF) codificado em Base64 (para Apollo/Vision).
file_mime_type string Não Tipo MIME (Ex: image/png). Obrigatório se file_base64 for enviado.

Response Body (JSON)

A API retorna um objeto JSON padronizado contendo a resposta textual e, se aplicável, a imagem gerada.

Campo Tipo Descrição
response string O texto de resposta da IA.
generated_image string (Base64) A imagem gerada em formato Base64 (apenas se usar o modelo Hefesto). Caso contrário, é null.
tokens_input integer Quantidade estimada de tokens de entrada processados.
tokens_output integer Quantidade estimada de tokens gerados.
response_time string Tempo total de execução da requisição (ex: "1200ms").

Códigos de Erro

Código Significado
200 Sucesso. Resposta gerada.
400 Parâmetros inválidos (ex: falta message).
401 Token inválido ou ausente.
404 Modelo não encontrado (verifique a URL).
413 Payload muito grande (Máximo 10MB).
502 Erro de comunicação com o provedor de IA (Gateway).

Gerador de Integração

Configure sua requisição abaixo e copie o código pronto para sua linguagem preferida.

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