Para clientes · API

Documentação da API

Sua API CodeFlow é compatível com Claude (Anthropic) e com OpenAI. Ou seja: funciona em qualquer ferramenta que aceite uma dessas APIs — Claude Code, Cursor, VS Code, clientes OpenAI, SDKs e scripts. Você só troca a URL e a chave.

Base URL

https://hudapi.cloudSem /v1 no Claude Code · com /v1 em clientes OpenAI

Sua chave

ck_…A chave que você recebeu. Em x-api-key ou Authorization: Bearer

Modelo

qualquerNão precisa escolher — qualquer nome de modelo que você mandar é atendido pelo nosso modelo

No Claude Code CLI, use a URL sem /v1 (https://hudapi.cloud). Em clientes OpenAI, use com /v1 (https://hudapi.cloud/v1).

Claude Code (terminal)

Aponte o Claude Code para a CodeFlow com duas variáveis de ambiente. Escolha seu sistema:

PowerShell

$env:ANTHROPIC_BASE_URL = "https://hudapi.cloud"
$env:ANTHROPIC_API_KEY  = "ck_SUA_KEY"
claude

Permanente (recomendado)

Crie ou edite o arquivo ~/.claude/settings.json (no Windows: C:\Users\SEU_USUARIO\.claude\settings.json):

settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://hudapi.cloud",
    "ANTHROPIC_API_KEY": "ck_SUA_KEY"
  }
}

Se existir um config.json na pasta .claude, apague antes de configurar.

IDEs (Cursor, VS Code, JetBrains…)

Funciona igual ao terminal — configure as mesmas variáveis no ambiente ou nas configurações da IDE:

ANTHROPIC_BASE_URL = https://hudapi.cloud
ANTHROPIC_API_KEY = ck_SUA_KEY

Clientes OpenAI (Jan.ai, etc.)

Configure a CodeFlow como um provedor OpenAI custom:

Base URL: https://hudapi.cloud/v1
API Key: ck_SUA_KEY

Usa o endpoint /v1/chat/completions (formato OpenAI).

API direta (curl / código)

A chave pode ir em x-api-key ou em Authorization: Bearer.

Formato Anthropic — POST /v1/messages

curl · Anthropic

curl https://hudapi.cloud/v1/messages \
  -H "x-api-key: ck_SUA_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "x",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Olá!"}]
  }'

Formato OpenAI — POST /v1/chat/completions

curl · OpenAI

curl https://hudapi.cloud/v1/chat/completions \
  -H "Authorization: Bearer ck_SUA_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "x",
    "messages": [{"role": "user", "content": "Olá!"}]
  }'

Streaming: adicione "stream": true no corpo. Ambos os formatos suportam SSE.

Busca na web (web search)

Mande uma tool chamada web_search no request (formato Anthropic, /v1/messages). A API faz a busca e devolve a resposta com informação atual.

curl · web_search

curl -N https://hudapi.cloud/v1/messages \
  -H "x-api-key: ck_SUA_KEY" -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "x", "max_tokens": 1024, "stream": true,
    "tools": [{"name":"web_search","description":"Busca na web",
               "input_schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}}],
    "tool_choice": {"type":"tool","name":"web_search"},
    "messages": [{"role":"user","content":"cotação do dólar hoje"}]
  }'

tool_choice força a busca. Sem ele, o modelo decide se busca ou não.
A busca está disponível só no /v1/messages (não no endpoint OpenAI).

Ver seu consumo

Consulte sua cota, quanto já usou na janela atual e quanto falta para resetar:

curl · GET /v1/me

curl https://hudapi.cloud/v1/me -H "Authorization: Bearer ck_SUA_KEY"

Retorna sua cota, quanto já usou na janela e quanto falta pra resetar.

Limites e erros

Limite por janela de 5h (em tokens). Ao atingir, as requests são recusadas com uma mensagem indicando em quanto tempo libera. A janela é deslizante — vai liberando sozinha.

Erros comuns

401 — chave inválida ou expirada.
400 com "Sem capacidade…" — pico momentâneo, tente de novo em instantes.
400 / 429 de cota — você atingiu o limite da janela; aguarde o reset.

Resumo rápido

Base URL: https://hudapi.cloud — sem /v1 no Claude Code; com /v1 em clientes OpenAI
Chave: ck_… — x-api-key ou Authorization: Bearer
Anthropic: POST /v1/messages
OpenAI: POST /v1/chat/completions
Modelos: GET /v1/models
Seu uso: GET /v1/me
Busca web: tool "web_search" no /v1/messages