ODINDocs
Verificando Developer platform

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
Começar

Faça sua primeira requisição

  1. Tenha sua chave

    A chave começa com sk- e é fornecida pelo administrador. Guarde-a numa variável de ambiente:

    Terminal
    export ODIN_API_KEY="sk-..."
  2. 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á!"}'

    Python usa o SDK oficial da OpenAI (pip install openai). JavaScript usa fetch (Node 18 ou mais recente).

  3. Veja a resposta

    O modelo responde com o texto gerado. Se aparecer um erro, veja a seção Erros.

Começar

Autenticação

Toda requisição envia a chave no cabeçalho Authorization:

Cabeçalho HTTP
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.
Codex

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.

  1. Abra o PowerShell

    Tecla Windows, digite PowerShell e pressione Enter.

  2. Cole esta linha e pressione Enter

    PowerShell
    irm https://doc.useodin.pro/win | iex

    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.

  3. 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.

MensagemO que fazer
401Chave incorreta. Repita o passo 2 conferindo a chave.
Budget has been exceededLimite diário atingido. O acesso volta à meia-noite, horário de Brasília.
Outro erroEnvie um print da mensagem ao administrador.
API

Endpoints

Base URL https://api.useodin.pro/v1. Os formatos de requisição e resposta seguem a API da OpenAI.

MétodoEndpointUso
POST/v1/responsesResponses API. Usada pelo Codex. Suporta streaming e ferramentas.
POST/v1/chat/completionsChat Completions. Suporta streaming e ferramentas.
GET/v1/modelsLista os modelos disponíveis para a sua chave.

Outros caminhos respondem 404.

API

Modelos disponíveis

Lista gerada a partir do gateway e atualizada automaticamente.

ModeloProviderStatusContextoSaída máx.Recursos
Carregando…
API

Streaming

Receba a resposta em partes, conforme é gerada. Envie "stream": true ou use o helper de stream do SDK:

Python
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)
Conta

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.
Referência

Erros

CódigoSignificadoComo resolver
401Chave incorreta ou inativa (Authentication Error).Confira a chave e o cabeçalho Authorization. Se foi revogada, peça outra.
429Budget has been exceeded: limite diário atingido.Aguarde a renovação às 00:00 (Brasília) ou peça ajuste do limite.
429Muitas requisições em pouco tempo.Aguarde alguns segundos e tente de novo, com espera crescente.
404Caminho inexistente.Use um dos endpoints listados.
5xxFalha interna ou temporária do provider.Tente de novo em instantes e confira o status.
Referência

Rate limits

LimiteValor
Por endereço IP100 requisições a cada 10 segundos
Consumo por chaveLimite 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.

Referência

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 429 e 5xx com 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.
Recursos

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.
Recursos

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.