Delfica AI · API

Documentação da API Delfica

Tudo que você precisa para a primeira requisição: uma base URL, uma key delficaai-…, model auto — e um comando para o Claude ou o Codex.

Base URL Autenticação Modelo Claude Codex CLI Endpoints Erros API Key Uso justo Get Started Clientes

Base URL

https://apiai.delfica.com.br/v1

Rotas HTTP de inferência ficam sob /v1. Claude Desktop e Claude Code usam o host https://apiai.delfica.com.br sem /v1 — o instalador grava isso. O endpoint autenticado /v1/models lista somente anthropic/claude-sonnet-auto (combo auto); o roteamento interno continua da Delfica.

Autenticação

Todas as requisições exigem sua API key (delficaai-…), enviada por Bearer token ou pelo header x-api-key.

# via Bearer token -H "Authorization: Bearer delficaai-sua_chave" # ou via header x-api-key -H "x-api-key: delficaai-sua_chave"

Nunca exponha a key no frontend de aplicações — use-a em backend ou em ferramentas locais.

Modelo

Nas chamadas HTTP e nos SDKs, envie "model": "auto". Esse é o único identificador público. O seletor do Claude Desktop, do Claude Code, do Codex e das outras ferramentas mostra só auto.

No Claude Desktop o id Anthropic correspondente é anthropic/claude-sonnet-auto (Delfica Auto).

"model": "auto"

Claude Desktop e Claude Code

Um comando. Troque SUA_CHAVE_DE_API pela key delficaai-…. O script liga o Developer Mode, grava a base sem /v1 e o modelo auto.

Windows PowerShell

# Claude Desktop
& ([scriptblock]::Create((irm 'https://apiai.delfica.com.br/i/claude-desktop/windows'))) 'SUA_CHAVE_DE_API'

# Claude Code
& ([scriptblock]::Create((irm 'https://apiai.delfica.com.br/i/claude-cli/windows'))) 'SUA_CHAVE_DE_API'

Linux

curl -fsSL 'https://apiai.delfica.com.br/i/claude-desktop/linux' | bash -s -- 'SUA_CHAVE_DE_API'
curl -fsSL 'https://apiai.delfica.com.br/i/claude-cli/linux' | bash -s -- 'SUA_CHAVE_DE_API'

macOS

curl -fsSL 'https://apiai.delfica.com.br/i/claude-desktop/macos' | bash -s -- 'SUA_CHAVE_DE_API'
curl -fsSL 'https://apiai.delfica.com.br/i/claude-cli/macos' | bash -s -- 'SUA_CHAVE_DE_API'

O instalador liga o Developer Mode e tenta encerrar o Claude para a config valer. Abra o app de novo. Deixe a URL do catálogo de modelos em branco. No seletor aparece só anthropic/claude-sonnet-auto (Delfica Auto).

Codex CLI e app Codex

Um comando. Troque SUA_CHAVE_DE_API pela key delficaai-… e rode num terminal comum, fora do Codex. O script grava ~/.codex/config.toml com a base com /v1, o modelo auto e o catálogo local, sem apagar seus MCPs, perfis e o login do ChatGPT.

Windows PowerShell

& ([scriptblock]::Create((irm 'https://apiai.delfica.com.br/i/codex/windows'))) 'SUA_CHAVE_DE_API'

Linux

curl -fsSL 'https://apiai.delfica.com.br/i/codex/linux' | bash -s -- 'SUA_CHAVE_DE_API'

macOS

curl -fsSL 'https://apiai.delfica.com.br/i/codex/macos' | bash -s -- 'SUA_CHAVE_DE_API'

Antes de gravar, o script fecha o Codex e o app do ChatGPT e passa as conversas antigas, inclusive as arquivadas, para a Delfica. No fim ele mostra um resumo e o backup em ~/.codex/backups; abra o Codex de novo. O contexto de 272.000 tokens preserva o fallback seguro do Codex 0.153.2; não anuncia 1 milhão sem garantia em todas as folhas do pool. O cliente envia model: auto; o roteamento interno não faz parte do contrato público.

Erro no Codex? Se aparecer The 'auto' model is not supported when using Codex with a ChatGPT account ou invalid type: sequence, expected a boolean (em features), rode o mesmo comando de novo. Ele corrige o config.toml e reassocia as conversas antigas.

Endpoints

POST /v1/chat/completions

OpenAI Chat Completions — o formato mais usado do mercado: messages, roles e respostas no padrão que suas bibliotecas já esperam.

curl https://apiai.delfica.com.br/v1/chat/completions \ -H "Authorization: Bearer delficaai-sua_chave" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Olá"}]}'

POST /v1/responses

OpenAI Responses — o protocolo de Responses da OpenAI, usado por ferramentas como o Codex CLI.

curl https://apiai.delfica.com.br/v1/responses \ -H "Authorization: Bearer delficaai-sua_chave" \ -H "Content-Type: application/json" \ -d '{"model":"auto","input":"Olá"}'

POST /v1/messages

Anthropic Messages — o protocolo do Claude, compatível com o Anthropic SDK, com o Claude Code e com o Claude Desktop.

curl https://apiai.delfica.com.br/v1/messages \ -H "x-api-key: delficaai-sua_chave" \ -H "Content-Type: application/json" \ -d '{"model":"auto","max_tokens":1024,"messages":[{"role":"user","content":"Olá"}]}'

POST /v1/messages/count_tokens

Anthropic Count Tokens — conte os tokens de uma requisição antes de enviá-la.

curl https://apiai.delfica.com.br/v1/messages/count_tokens \ -H "x-api-key: delficaai-sua_chave" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Olá"}]}'

GET /i

Instalador em texto puro. Claude Desktop: /i/claude-desktop/<os>, Claude Code: /i/claude-cli/<os>, Codex: /i/codex/<os>. O sistema é windows, linux ou macos. A query antiga /i?tool=&os= continua válida. Não autentica: o script pede a key como argumento.

curl -fsSL 'https://apiai.delfica.com.br/i/claude-desktop/linux' curl -fsSL 'https://apiai.delfica.com.br/i/codex/linux'

Erros

400 — Requisição inválida Corpo, modelo ou parâmetros incorretos. Corrija o pedido. Não tente de novo até ajustar a requisição.

401 — Não autenticado Key ausente, inválida ou regenerada. Confira o header de autenticação e, se necessário, gere uma nova key no painel.

413 — Requisição acima da política de uso justo A requisição excedeu o limite de tamanho da política de uso justo. Reduza o tamanho do request e tente novamente.

429 — Limite de uso justo A requisição excedeu um limite de ritmo da política de uso justo. Aguarde o intervalo indicado no header Retry-After e tente novamente. Não há cobrança associada.

5xx — Erro temporário do serviço Falha transitória. Só tente de novo se a requisição for segura de repetir (idempotente). Não reenvie operações que não possam ser repetidas.

Erros mantêm o formato do protocolo chamado (OpenAI ou Anthropic) para não quebrar seus clientes e SDKs.

Gestão da API Key

Sua key é exibida uma única vez, na criação. Guarde-a em um local seguro.

Perdeu ou comprometeu a key? No painel, solicite a rotação: um link privado chega ao seu e-mail e a nova key é exibida uma única vez. A key anterior pode continuar válida por até 15 minutos durante a troca.

Como acessar o painel O link privado do painel chega por e-mail após a assinatura. Sem senha — o link é o acesso.

Formato da key delficaai-… — copie e guarde quando ela for exibida no painel.

Limites e uso justo

O uso é ilimitado, sem cobrança por token, sujeito à política de uso justo: limites inteligentes de ritmo e de tamanho por requisição, que protegem a estabilidade do serviço para todos os clientes. Não há teto publicado. Requisições acima de um limite recebem 429 com o header Retry-After — aguarde e reenvie. Nunca há cobrança adicional.

Retenção de dados: detalhes de consumo ficam disponíveis por 31 dias; os agregados, permanentemente. O conteúdo das requisições não é armazenado e não é usado para treinar modelos.

Ainda não tem uma key?

Assine, receba sua key em minutos e use em qualquer cliente OpenAI/Anthropic. O Get Started lista o Claude, o Codex e todos os clientes.

Assinar agora