Integre uma vez.
Construa sem atrito.
A API do ODIN conecta seus produtos aos modelos da OpenAI com uma interface familiar, governança por chave e uma operação preparada para crescer.
- Base URL
- https://api.useodin.pro/v1
- Autenticação
- Authorization: Bearer sk-...
- Formato
- JSON, compatível com a API da OpenAI
- Provider
- OpenAI
Faça sua primeira requisição
Tenha sua chave
A chave começa com
sk-e é fornecida pelo administrador. Guarde-a numa variável de ambiente:Terminalexport ODIN_API_KEY="sk-..."
Execute uma requisição
curl https://api.useodin.pro/v1/responses \ -H "Authorization: Bearer $ODIN_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "gpt-5.6-sol", "input": "Olá!"}'
import os from openai import OpenAI client = OpenAI(base_url="https://api.useodin.pro/v1", api_key=os.environ["ODIN_API_KEY"]) resposta = client.responses.create(model="gpt-5.6-sol", input="Olá!") print(resposta.output_text)
const resposta = await fetch("https://api.useodin.pro/v1/responses", { method: "POST", headers: { "Authorization": `Bearer ${process.env.ODIN_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ model: "gpt-5.6-sol", input: "Olá!" }), }); const dados = await resposta.json(); console.log(dados.output.find(o => o.type === "message").content[0].text);
Python usa o SDK oficial da OpenAI (
pip install openai). JavaScript usafetch(Node 18 ou mais recente).Veja a resposta
O modelo responde com o texto gerado. Se aparecer um erro, veja a seção Erros.
Autenticação
Toda requisição envia a chave no cabeçalho Authorization:
Authorization: Bearer SUA_CHAVE
- A chave começa com
sk-e é individual. - Guarde-a em variável de ambiente (
ODIN_API_KEY=sk-...), nunca no código. - Nunca use a chave em código que roda no navegador ou em aplicativo distribuído.
Configurar Codex
Conecte o Codex ao ODIN em menos de um minuto. Vale para o terminal, o aplicativo do Codex e a extensão do VS Code.
Você vai precisar da sua chave de acesso (começa com sk-), fornecida pelo administrador.
Abra o PowerShell
Abra o Terminal
Tecla Windows, digite PowerShell e pressione Enter.
No Mac: Cmd + Espaço, digite Terminal e pressione Enter.
Cole esta linha e pressione Enter
PowerShellirm https://doc.useodin.pro/win | iex
Terminalcurl -fsSL https://doc.useodin.pro/mac | bash
Quando pedir, cole sua chave. Se o Codex ainda não estiver instalado, ele é instalado automaticamente. Se já estiver, suas configurações são mantidas.
Pronto
Abra um terminal novo e digite
codex. Se você usa o aplicativo do Codex ou a extensão do VS Code, feche e abra o aplicativo: ele já estará conectado.
| Mensagem | O que fazer |
|---|---|
| 401 | Chave incorreta. Repita o passo 2 conferindo a chave. |
| Budget has been exceeded | Limite diário atingido. O acesso volta à meia-noite, horário de Brasília. |
| Outro erro | Envie um print da mensagem ao administrador. |
Endpoints
Base URL https://api.useodin.pro/v1. Os formatos de requisição e resposta seguem a API da OpenAI.
| Método | Endpoint | Uso |
|---|---|---|
| POST | /v1/responses | Responses API. Usada pelo Codex. Suporta streaming e ferramentas. |
| POST | /v1/chat/completions | Chat Completions. Suporta streaming e ferramentas. |
| GET | /v1/models | Lista os modelos disponíveis para a sua chave. |
Outros caminhos respondem 404.
Modelos disponíveis
Lista gerada a partir do gateway e atualizada automaticamente.
| Modelo | Provider | Status | Contexto | Saída máx. | Recursos |
|---|---|---|---|---|---|
| Carregando… | |||||
Streaming
Receba a resposta em partes, conforme é gerada. Envie "stream": true ou use o helper de stream do SDK:
with client.responses.stream(model="gpt-5.6-sol", input="Conte de 1 a 5.") as stream: for evento in stream: if evento.type == "response.output_text.delta": print(evento.delta, end="", flush=True)
Chaves e limites
As chaves são criadas, ajustadas e revogadas pelo administrador da sua conta.
- Uma chave por uso
- Uma chave por pessoa ou aplicação. Peça chaves separadas para produção e desenvolvimento.
- Limite diário
- Cada chave tem um limite de consumo por dia, renovado às 00:00, horário de Brasília.
- Registro de uso
- Requisições, tokens de entrada e saída, custo e modelo, por chave e por dia.
- Revogação
- Uma chave revogada para de funcionar na hora, sem afetar as outras.
Erros
| Código | Significado | Como resolver |
|---|---|---|
| 401 | Chave incorreta ou inativa (Authentication Error). | Confira a chave e o cabeçalho Authorization. Se foi revogada, peça outra. |
| 429 | Budget has been exceeded: limite diário atingido. | Aguarde a renovação às 00:00 (Brasília) ou peça ajuste do limite. |
| 429 | Muitas requisições em pouco tempo. | Aguarde alguns segundos e tente de novo, com espera crescente. |
| 404 | Caminho inexistente. | Use um dos endpoints listados. |
| 5xx | Falha interna ou temporária do provider. | Tente de novo em instantes e confira o status. |
Rate limits
| Limite | Valor |
|---|---|
| Por endereço IP | 100 requisições a cada 10 segundos |
| Consumo por chave | Limite diário definido para cada chave, renovado às 00:00 (Brasília) |
| Por minuto (RPM/TPM) | Definido por chave pelo administrador, quando necessário |
Quando uma conta do provider atinge o limite dela, o ODIN encaminha a requisição para outra conta disponível.
Boas práticas
- Guarde a chave em variável de ambiente. Nunca em código que vai para o navegador.
- Use uma chave para produção e outra para desenvolvimento.
- Trate
429e5xxcom nova tentativa e espera crescente. - Continue na mesma sessão quando o assunto for o mesmo: o contexto repetido sai mais barato.
- Mantenha pedidos objetivos. Contexto desnecessário custa tokens.
Changelog
19 SET 2026
- NovoConfiguração do Codex em uma linha para Windows, macOS e Linux, incluindo o aplicativo do Codex e o VS Code.
- NovoPágina de status pública, com verificação a cada minuto.
- MelhoriaLimite diário renovado à meia-noite, horário de Brasília.
- MelhoriaCada chave é mantida na mesma conta do provider para reaproveitar o cache de contexto.
- MelhoriaAtualizações sem interrupção, com múltiplas réplicas do gateway.
- CorreçãoNova tentativa automática em falhas temporárias do provider.
Suporte
Antes de entrar em contato, veja os erros comuns e o status do ODIN.
Ainda precisa de ajuda? Fale com o administrador responsável pela sua conta e envie um print da mensagem de erro.