DevHub BrasilDOCUMENTACIÓN
PanelReferencia de la API ↗
ES

Precios en reales brasileños (BRL). Por ahora, el checkout solo está disponible en Brasil mediante PIX o tarjeta.

DE LA CONFIGURACIÓN A TU PRIMERA RESPUESTA

Conecta DevHub a tu flujo de trabajo.

Más fácil con DevHub Chat. Con un pase activo, no necesitas elegir una clave. Para usar Gateway y tus herramientas, crea una clave en Claves de API. Las claves nuevas se cifran y pueden volver a consultarse. Las claves antiguas guardadas solo como hash siguen funcionando, pero no se pueden recuperar.

Crea una clave en el panel, elige un modelo del catálogo y configura tu herramienta. Para clientes compatibles con OpenAI, usa https://api.devhubbrasil.com/v1. Para Claude Code, usa la URL raíz https://api.devhubbrasil.com.

Los tres datos de conexión

Campo Valor de ejemplo
Base URL · OpenAI https://api.devhubbrasil.com/v1
API key dh_SUA_CHAVE
Model ID O ID exato mostrado en el catálogo do console
  1. Abre el panel y entra en Claves de API. Crea una clave con inference e models:read.
  2. Copia y guarda la clave completa en un lugar seguro. Puedes volver a consultar las claves nuevas con “Ver clave”; las antiguas guardadas solo como hash no se pueden recuperar.
  3. Abra DevHub Chat. Elige Automático o un modelo y envía una solicitud breve.
  4. Comprueba la respuesta, el uso y el saldo antes de configurar una herramienta que haga muchas solicitudes.

O modelo devhub-echo, cuando está habilitado, sirve para probar la integración y devuelve texto simulado. Para usar IA real, elige un modelo de un proveedor configurado en el catálogo.

CATÁLOGO Y ENRUTAMIENTO

¿Qué Model ID debo usar?

Usa el ID exacto que aparece en el Catálogo de modelos o en GET /v1/models. El nombre que aparece en el selector es la etiqueta visible; el Model ID es el valor que debes enviar en el campo model de la solicitud. Ejemplos que pueden aparecer en el catálogo: claude-sonnet-5, claude-fable-5.1 e gpt-5.5. El catálogo de tu consola es la referencia actual; los nombres y la disponibilidad pueden cambiar.

El ID selecciona una entrada del catálogo de DevHub. El Gateway decide qué proveedor configurado atiende la solicitud y puede usar una ruta de respaldo. El nombre del catálogo, por sí solo, . no demuestra que la solicitud haya sido atendida por la API oficial de la empresa asociada al modelo. Una clave de API de DevHub tampoco es una suscripción oficial de Claude, ChatGPT u otra aplicación.

Las funciones dependen del modelo y de la ruta: el texto, las imágenes, el audio, las herramientas y el contexto pueden variar. Revisa las capacidades del catálogo y haz una prueba pequeña antes de usar archivos o flujos largos.

Consultar los IDs disponibles

curl https://api.devhubbrasil.com/v1/models \
  -H "Authorization: Bearer dh_SUA_CHAVE"
APLICACIÓN · WINDOWS

Instalar el Gateway en Windows

  1. Abre la página de DevHub y descarga el instalador de Gateway para Windows. Comprueba la versión que aparece en el botón de descarga.
  2. Abre el archivo descargado y sigue los pasos del instalador. Si Windows muestra una advertencia, comprueba el origen y la firma del archivo. Si no puedes verificar al editor, no omitas el bloqueo y contacta con soporte.
  3. Abre Gateway y conéctate con una clave creada en Claves de API y elige un Model ID disponible en el catálogo.
  4. Envía una pregunta breve. Si falla la conexión, comprueba la URL base que muestra Gateway, la clave, el pase activo y el Model ID. No pegues la clave en conversaciones, capturas ni solicitudes públicas de soporte.

El instalador de Gateway es para Windows. En macOS, sigue el tutorial de API/Claude Code; en Linux, elige el paquete compatible con tu distribución y arquitectura. Usa siempre la versión indicada en la página de descargas.

VISUAL STUDIO CODE

Cline

  1. Abre la extensión Cline en VS Code y entra en la configuración.
  2. Em API Provider, selecione OpenAI Compatible.
  3. Introduce la Base URL terminada en /v1 e sua chave dh_....
  4. Indica Model ID con el ID del modelo que aparece en el catálogo DevHub.
  5. Si la extensión solicita una ventana de contexto o un límite de salida, usa valores compatibles con el modelo. Empieza con una tarea pequeña y revisa el uso.

Activa funciones como imágenes o herramientas solo si el modelo las admite. Los flujos de agente también dependen del comportamiento del modelo y de la versión de la extensión.

VISUAL STUDIO CODE

Continue

En la configuración YAML de Continue, añade un modelo con provider: openai e sua URL em apiBase. Gateway ofrece Chat Completions; configura useResponsesApi: false quando necessário.

name: DevHub AI
version: 1.0.0
schema: v1
models:
  - name: Meu modelo DevHub
    provider: openai
    model: ID_DO_MODELO
    apiBase: https://api.devhubbrasil.com/v1
    apiKey: dh_SUA_CHAVE
    useResponsesApi: false

Guarda esta configuración en un archivo local privado o usa el gestor de secretos de tu versión de Continue. No incluyas la clave en un repositorio.

EDITOR

Cursor

  1. Em Settings → Models, procure as opções de chaves de API próprias.
  2. Se sua versão oferecer Override OpenAI Base URL, habilite e informe https://api.devhubbrasil.com/v1.
  3. Configura tu clave DevHub en la conexión OpenAI y activa su uso.
  4. Selecciona o añade un Model ID que coincida exactamente con el catálogo de Gateway.
  5. Envía un mensaje breve y comprueba que la solicitud aparezca en el historial de DevHub.

La disponibilidad de una Base URL personalizada y de las funciones que usan la clave depende de la versión y el plan de Cursor. Las funciones propias de Cursor, los modelos de otros protocolos y Tab Completion pueden usar la infraestructura de Cursor. Esta conexión no sustituye la suscripción de la herramienta ni garantiza compatibilidad con todos los modelos o funciones.

TERMINAL · COMPATIBILIDAD EXPERIMENTAL

Claude Code

Claude Code usa el protocolo Anthropic. DevHub ofrece /v1/messages; configure a URL raiz, pois o cliente acrescenta /v1/messages. Não acrescente /v1 à variável abaixo.

PowerShell:

$env:ANTHROPIC_BASE_URL="https://api.devhubbrasil.com"
$env:ANTHROPIC_AUTH_TOKEN="dh_SUA_CHAVE"
$env:ANTHROPIC_MODEL="ID_DO_MODELO"
claude

macOS / Linux:

export ANTHROPIC_BASE_URL="https://api.devhubbrasil.com"
export ANTHROPIC_AUTH_TOKEN="dh_SUA_CHAVE"
export ANTHROPIC_MODEL="ID_DO_MODELO"
claude

La compatibilidad con Anthropic en esta instalación es experimental. Incluye texto, streaming y traducción de llamadas a herramientas para los modelos que lo admiten. El recuento de tokens es una estimación local. No están implementados Thinking, las herramientas nativas del servidor, los documentos/PDF ni la caché avanzada de prompts. Esta configuración no certifica el funcionamiento completo del agente. Anthropic no admite el uso de Claude Code con modelos que no sean Claude.

Usa una clave específica para este cliente y prueba lectura, edición y ejecución en un proyecto desechable antes de usarlo para trabajo real.

TUTORIAL · MACOS

Usar la API de DevHub en Mac

Este tutorial configura Claude Code CLI en macOS para enviar solicitudes a la API de DevHub. Por ahora, esta documentación no ofrece un instalador de Gateway para macOS; la conexión se configura desde la Terminal.

  1. Entra en console DevHub, crie una clave de API com permissão de inferência e guarde-a em local privado. Não a envie por mensagem ou captura de tela.
  2. Abre Terminal. Instala Claude Code con el instalador oficial de Anthropic y comprueba la instalación:
curl -fsSL https://claude.ai/install.sh | bash
claude --version

Para testar primeiro nesta janela do Terminal, configure a URL raiz (sem /v1) e a chave. Depois inicie o Claude Code:

export ANTHROPIC_BASE_URL="https://api.devhubbrasil.com"
export ANTHROPIC_AUTH_TOKEN="dh_SUA_CHAVE"
claude

Dentro do Claude Code, rode /status e confirme que a URL base mostra https://api.devhubbrasil.com. Elige um Model ID que apareça en el catálogo DevHub e teste uma pergunta curta. As variáveis acima valem para essa janela do Terminal.

Para manter a conexão em novas janelas, crie a pasta e abra o arquivo pessoal de configurações:

mkdir -p ~/.claude
nano ~/.claude/settings.json

Coloque este conteúdo no arquivo, substituindo dh_SUA_CHAVE pela sua chave privada:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.devhubbrasil.com",
    "ANTHROPIC_AUTH_TOKEN": "dh_SUA_CHAVE"
  }
}

Salve e feche o editor, depois proteja a chave: chmod 600 ~/.claude/settings.json. Evite salvar a chave em arquivos do projeto ou repositórios. Se usar a extensão do VS Code, configure também as variáveis nas configurações de ambiente da extensão; ela pode não herdar valores do Terminal.

La integración de Anthropic con Claude Code es experimental. Pueden funcionar el texto, el streaming y algunas herramientas; es posible que no estén disponibles las funciones que dependen de extensiones específicas del protocolo. Anthropic no admite modelos que no sean Claude. Si algo falla, comprueba /status, a chave/permissão en el panel e o ID exato do modelo.

TUTORIAL · LINUX

Instalar y abrir Gateway en Linux

El sitio ofrece Gateway para Linux en amd64/x86-64. En Ubuntu/Debian, usa el paquete .deb, que instala las dependencias del sistema. Descárgalo desde la página principal y comprueba que la versión del nombre del archivo coincida con la del botón de descarga. Abre la Terminal en la carpeta Descargas:

cd ~/Downloads
sudo apt update
sudo apt install ./DevHub-Brasil-Gateway-VERSAO-linux.deb

Después, abre DevHub Brasil Gateway desde el menú de aplicaciones. La primera vez, conéctate con tu clave de DevHub y selecciona un modelo del catálogo. Puedes iniciar AppImage así:

chmod +x ~/Downloads/DevHub-Brasil-Gateway-VERSAO-linux.AppImage
~/Downloads/DevHub-Brasil-Gateway-VERSAO-linux.AppImage

Sustituye VERSAO por el número que aparece en el nombre del archivo descargado. En Ubuntu/Debian, también puedes usar este comando desde la carpeta Descargas:

sudo apt install ./NOME_EXATO_DO_ARQUIVO.deb

Se o sistema disser “dependência não satisfeita”, atualize a lista com sudo apt update e repita sudo apt install ./arquivo.deb; não use dpkg -i sozinho, pois ele não baixa dependências automaticamente. Se o aplicativo não abrir, envie ao suporte a distribuição/versão do Linux e a mensagem completa do Terminal. O pacote é para sistemas x86-64, não ARM.

SEU APLICATIVO

SDK OpenAI e HTTP

Use Chat Completions com a Base URL DevHub. Mantenha a chave no servidor ou em variáveis de ambiente de uma aplicação local.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEVHUB_API_KEY"],
    base_url="https://api.devhubbrasil.com/v1",
)
response = client.chat.completions.create(
    model="ID_DO_MODELO",
    messages=[{"role": "user", "content": "Olá"}],
    max_tokens=512,
)
print(response.choices[0].message.content)

Streaming:

stream = client.chat.completions.create(
    model="ID_DO_MODELO",
    messages=[{"role": "user", "content": "Olá"}],
    max_tokens=512,
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="")

cURL (macOS/Linux; troque curl por curl.exe no Windows e adapte a continuação de linhas ao seu terminal):

curl https://api.devhubbrasil.com/v1/models \
  -H "Authorization: Bearer $DEVHUB_API_KEY"

curl https://api.devhubbrasil.com/v1/chat/completions \
  -H "Authorization: Bearer $DEVHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"ID_DO_MODELO","messages":[{"role":"user","content":"Olá"}],"max_tokens":512,"stream":true}'

PowerShell, sem depender do escape de aspas do cURL:

$body = @{
  model = "ID_DO_MODELO"
  messages = @(@{ role = "user"; content = "Olá" })
  max_tokens = 512
} | ConvertTo-Json -Depth 10

Invoke-RestMethod -Method Post `
  -Uri "https://api.devhubbrasil.com/v1/chat/completions" `
  -Headers @{ Authorization = "Bearer $env:DEVHUB_API_KEY" } `
  -ContentType "application/json" -Body $body

El Gateway también ofrece POST /v1/responses en modo de compatibilidad parcial: entrada de texto, respuesta básica y conversión limitada de herramientas. Este adaptador no conserva las imágenes enviadas por esta ruta y no equivale a toda la API Responses de OpenAI. POST /v1/messages/count_tokens devuelve una estimación local, no un recuento nativo del proveedor. Esta referencia no incluye embeddings ni endpoints específicos de audio o imágenes. Las herramientas y los formatos de salida dependen del modelo y del adaptador configurado.

Abrir a referência dos endpoints ↗
CONTROLE DE USO

Passes, limites e respostas de erro

O pase activo dá acesso à API durante o período contratado, dentro do teto diário de tokens do passe. Ao atingir o teto diário, a API responde 429 e o uso volta no dia seguinte. Não há janela de 5 horas nem limite semanal. O gateway mede o uso para segurança e operação. Continuam valendo os límites técnicos de taxa/contexto, disponibilidade e políticas dos proveedores.

Código O que verificar
400 / 422 Campos, conteúdo e parâmetros da chamada.
401 / 403 Chave válida, permissões e situação da conta.
402 Passe ativo ou saldo legado disponível.
404 URL do endpoint e Model ID do catálogo.
429 Límite de solicitudes; respeta el encabezado Retry-After.
502 / 503 Disponibilidad del servicio o proveedor. Espera y vuelve a intentarlo con intervalos cada vez mayores.

Guarde o X-Request-ID retornado para localizar a chamada no histórico. Interromper streaming pode gerar consumo pelos tokens já processados. Um modelo simulado não valida os recursos de um provedor real.

Boas práticas para suas chaves

  • Usa una clave por proyecto o herramienta y concede solo los permisos necesarios.
  • No publiques claves en sitios, capturas de pantalla, registros o repositorios.
  • Rota una clave expuesta y actualiza la configuración. La clave anterior deja de funcionar de inmediato.
  • Usa HTTPS en producción y consulta el historial si tienes dudas sobre el uso.

Pagamento e liberação automática

Elige um passe en el panel e conclua o pagamento pelo meio disponível. El pase é ativado automaticamente assim que o provedor confirma o pagamento. Enquanto o pedido aparecer como pendente ou em revisão, a confirmação ainda não chegou; atualize o status e não faça outro pagamento para o mesmo pedido.

REFERÊNCIA DA API

API OpenAI-compatible e Gateway Anthropic

Use una clave de API DevHub com permissão de inferência. El pase precisa estar ativo. Envie a chave no header indicado abaixo; não exponha chaves no código de páginas públicas.

Acesso por pase activo: o uso é limitado pelo teto diário de tokens do passe (o valor de cada passe está em /precos e en el panel). Ao atingir o teto, a API responde 429 e o uso volta no dia seguinte. Passe ativo e chave válida continuam obrigatórios. Ventana de contexto e saída máxima por chamada, limites de taxa, disponibilidade e políticas do provedor continuam aplicáveis.

MétodoEndpointUso
GET/v1/modelsConsultar modelos disponíveis para a sua chave
POST/v1/chat/completionsConversas no formato OpenAI, com streaming opcional
POST/v1/messagesGateway no formato Anthropic
POST/v1/messages/count_tokensEstimativa local de tokens de entrada
POST/v1/responsesCompatibilidade parcial com a API Responses

Chat Completions

curl https://api.devhubbrasil.com/v1/chat/completions \
  -H "Authorization: Bearer dh_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Olá!"}],"max_tokens":512,"stream":false}'

A resposta segue o formato choices[0].message.content. Com stream: true, leia os eventos SSE data: até [DONE].

Anthropic Messages

curl https://api.devhubbrasil.com/v1/messages \
  -H "x-api-key: dh_SUA_CHAVE" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":512,"messages":[{"role":"user","content":"Olá!"}]}'

Erros e limites

401: confira a chave. 403: confira permissões e acesso. 429: limite técnico, aguarde a janela indicada. 502/503: falha ou indisponibilidade temporária do upstream. Consulta as seções de integração e erros para detalhes.

Esta é a referência pública de integração. O Swagger interno não é exposto em produção. Todas as chamadas e limites continuam nas rotas existentes.

Não encontrou? Chama — 61 99823-9879