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 RESPUESTAConecta DevHub a tu flujo de trabajo.
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 |
-
Abre el panel y entra en Claves de API. Crea una clave con
inferenceemodels:read. - 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.
- Abra DevHub Chat. Elige Automático o un modelo y envía una solicitud breve.
- 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.
¿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"
Instalar el Gateway en Windows
- 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.
- 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.
- Abre Gateway y conéctate con una clave creada en Claves de API y elige un Model ID disponible en el catálogo.
- 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.
Cline
- Abre la extensión Cline en VS Code y entra en la configuración.
- Em API Provider, selecione OpenAI Compatible.
-
Introduce la Base URL terminada en
/v1e sua chavedh_.... - Indica Model ID con el ID del modelo que aparece en el catálogo DevHub.
- 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.
Referência: configuração oficial do Cline.
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.
Referência: proveedores OpenAI compatíveis no Continue.
Cursor
- Em Settings → Models, procure as opções de chaves de API próprias.
-
Se sua versão oferecer Override OpenAI Base URL,
habilite e informe
https://api.devhubbrasil.com/v1. - Configura tu clave DevHub en la conexión OpenAI y activa su uso.
- Selecciona o añade un Model ID que coincida exactamente con el catálogo de Gateway.
- 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.
Referência: documentação oficial do Cursor. Consulta as opções de modelos e API Keys da versão instalada.
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.
Referência: guia oficial de gateways do Claude Code.
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.
- 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.
- 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.
Referências: instalação oficial do Claude Code · conexão oficial com um gateway.
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.
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.
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.
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étodo | Endpoint | Uso |
|---|---|---|
| GET | /v1/models | Consultar modelos disponíveis para a sua chave |
| POST | /v1/chat/completions | Conversas no formato OpenAI, com streaming opcional |
| POST | /v1/messages | Gateway no formato Anthropic |
| POST | /v1/messages/count_tokens | Estimativa local de tokens de entrada |
| POST | /v1/responses | Compatibilidade 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.