SDK OpenAI com os modelos do DevHub Brasil

Qualquer SDK oficial da OpenAI aceita uma base URL alternativa. É o caminho para usar o catálogo a partir de código próprio, sem depender de uma ferramenta de editor.

Como configurar

1. Instale o SDK oficial da OpenAI na versão do seu projeto.
2. Passe base_url apontando para o valor terminado em /v1.
3. Passe a chave DevHub como api_key.
4. Use o ID exato do catálogo no campo model de cada chamada.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.devhubbrasil.com/v1",
    api_key="dh_SUA_CHAVE",
)

resposta = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "Olá"}],
)
print(resposta.choices[0].message.content)

Qual modelo escolher no SDK OpenAI

O modelo é escolhido por chamada, não pela configuração de SDK OpenAI. Isso significa que você pode trocar de modelo no meio de uma tarefa sem reconfigurar nada. A tabela abaixo é o catálogo inteiro com o preço que vale dentro desta ferramenta.

Modelo por modelo dentro do SDK OpenAI

Sem reenvio automático de arquivos, a chamada envia só o que você escreveu. Aqui o preço por milhão decide primeiro, e a ordem abaixo segue esse critério.

O que muda no consumo

Controle total sobre o que é enviado. Aqui o custo é uma decisão de engenharia: você escolhe quanto histórico reenviar por chamada e pode truncar antes de enviar, em vez de deixar o cliente decidir.

Limites desta configuração

O SDK valida o formato das respostas, não a capacidade do modelo. Recursos como chamada de função exigem que o modelo escolhido suporte ferramentas.

Testar sem instalar nada

Antes de configurar a ferramenta, confirme que a chave e o modelo respondem. Este comando usa o protocolo API compatível com OpenAI:

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

Um 401 indica chave inválida; um 402 indica passe expirado ou não ativado. Uma resposta com texto confirma que o problema restante, se houver, está na ferramenta e não na conexão.