O OpenAI Agents SDK pode usar outro fornecedor?

Sim, qualquer endpoint que use o protocolo da OpenAI. Passe um cliente AsyncOpenAI com base_url https://aigrow.gg/v1 e a sua chave para set_default_openai_client, e chame set_default_openai_api("chat_completions").

Porque é que o Agents SDK devolve um erro 404 com um base URL personalizado?

Por predefinição, chama a Responses API, e o endpoint só disponibiliza chat completions. set_default_openai_api("chat_completions") ou OpenAIChatCompletionsModel resolvem a situação.

O que faz o tracing sem uma chave da OpenAI?

O tracing vem ativado por predefinição e envia cada execução para a OpenAI com a mesma chave das chamadas ao modelo, pelo que, com uma chave da AIGROW, o envio falha com um erro de tracing 401. Desative-o com set_tracing_disabled(True) ou OPENAI_AGENTS_DISABLE_TRACING=1, ou indique-lhe uma chave da OpenAI com set_tracing_export_api_key.

Um agente pode funcionar com um modelo Claude?

Sim. O endpoint disponibiliza modelos Claude no protocolo da OpenAI, pelo que model="claude-opus-5.5" funciona com o cliente do bloco, sem adaptador para instalar.

O OpenAI Agents SDK com um URL base personalizado

Dê ao SDK este cliente, mude-o para chat completions e desative o tracing, e os seus agentes passam a correr em modelos Claude, GPT e Grok com a sua chave da AIGROW.

Comprar crédito de API

Já tem um código? Resgate-o em Acesso à API e depois crie uma chave.

Python, antes de criar um agente

from openai import AsyncOpenAI
from agents import (
    Agent,
    Runner,
    set_default_openai_api,
    set_default_openai_client,
    set_tracing_disabled,
)

client = AsyncOpenAI(base_url="https://aigrow.gg/v1", api_key="ag_your_key_here")
set_default_openai_client(client, use_for_tracing=False)
set_default_openai_api("chat_completions")
set_tracing_disabled(True)

agent = Agent(name="Assistant", model="claude-opus-5.5")
result = Runner.run_sync(agent, "Reply with the word ready")
print(result.final_output)

Substitua ag_your_key_here por uma chave de Acesso à API.

Onde fica a definição

Pacote Python: pip install openai-agents

Ou um agente de cada vez

O OpenAIChatCompletionsModel coloca um único agente em chat completions através do seu próprio cliente e deixa as predefinições do SDK como estão.

from openai import AsyncOpenAI
from agents import Agent, OpenAIChatCompletionsModel, set_tracing_disabled

set_tracing_disabled(True)
client = AsyncOpenAI(base_url="https://aigrow.gg/v1", api_key="ag_your_key_here")

agent = Agent(
    name="Assistant",
    model=OpenAIChatCompletionsModel(model="gpt-6-astra", openai_client=client),
)

Ou com variáveis de ambiente

O cliente OpenAI lê estas duas por si, e a última desativa o tracing. O seu código continua a chamar set_default_openai_api("chat_completions") antes da primeira execução.

export OPENAI_BASE_URL=https://aigrow.gg/v1
export OPENAI_API_KEY=ag_your_key_here
export OPENAI_AGENTS_DISABLE_TRACING=1

Que modelo usar

Introduza o id exatamente como está escrito aqui.

Claude Opus 5.5claude-opus-5.5: A opção predefinida em todos os blocos desta página e o modelo Claude mais barato aqui por token enviado e recebido. Contexto: 1 000 000 tokens.
Grok 4.7grok-4.7: O preço de saída mais baixo aqui. O seu contexto tem metade do tamanho dos modelos Claude. Contexto: 500 000 tokens.
GPT-6 Astragpt-6-astra: Para um modelo GPT. Custa o mesmo por token que o Fable e mais do que o Opus. Contexto: 1 050 000 tokens.
Claude Fable 5.1claude-fable-5.1: Custa mais por token do que o Opus. Compare os dois no ranking de programação antes de mudar. Contexto: 1 000 000 tokens.

A lista de preços tem todos os ids e a respetiva taxa de crédito, os preços da API do Claude indicam os preços de tabela e o ranking de programação compara os modelos em prompts de programação.

Verifique se funciona

Primeiro a chave isolada, depois o OpenAI Agents SDK com ela.

A chave

Peça a lista de modelos. Requer uma chave válida e não custa nada.

curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"

Uma chave válida devolve a lista:

{
  "object": "list",
  "data": [
    { "id": "claude-opus-5.5", "object": "model", ... },
    { "id": "claude-fable-5.1", "object": "model", ... },
    { "id": "gpt-6-astra", "object": "model", ... },
    { "id": "claude-sonnet-5.5", "object": "model", ... },
    { "id": "gpt-6.1-sol", "object": "model", ... },
    { "id": "grok-4.7", "object": "model", ... },
    ...
  ],
  "has_more": false
}

OpenAI Agents SDK

Guarde o bloco como check.py, insira a sua chave e execute-o.

python check.py

Uma configuração correta imprime a resposta do agente:

ready

Quando falha

Primeiro os erros do OpenAI Agents SDK, depois as respostas que o endpoint dá a qualquer ferramenta.

404 em todas as execuções: O SDK continua na Responses API, que é a predefinição. Chame set_default_openai_api("chat_completions") antes da primeira execução, ou dê ao agente um OpenAIChatCompletionsModel.
Erro 401 do cliente de tracing: O tracing envia cada execução para a OpenAI com a mesma chave das chamadas ao modelo, e uma chave da AIGROW não é uma chave da OpenAI. set_tracing_disabled(True) interrompe o envio; set_tracing_export_api_key com uma chave de platform.openai.com mantém-no.
A minha ferramenta indica 401 ou erro de autenticação: A chave está em falta ou foi escrita incorretamente. Copie-a de novo em Acesso à API no painel e certifique-se de que é enviada como chave, e não como nome de modelo. Uma chave revogada falha da mesma forma: crie uma nova e substitua-a.
Recebo 402 ou uma mensagem sobre crédito: O seu saldo está vazio. Abra Acesso à API no painel, resgate um código ou compre outro pacote e o pedido seguinte será processado. Não é preciso mudar mais nada.
Aparece 404 ou Unknown model: O modelo tem de ser um dos que o endpoint disponibiliza, por exemplo claude-opus-5.5. A grafia própria do fornecedor também funciona (claude-opus-5-5, anthropic/claude-opus-5.5), mas um id com data ou qualquer modelo fora do catálogo é rejeitado antes de o pedido ser encaminhado e nada é cobrado. Peça GET /v1/models com a sua chave para obter a lista atual, ou consulte os ids na lista de preços.
Os pedidos são rejeitados com 429: A capacidade do endpoint é partilhada por todos os clientes: cerca de 20 pedidos por minuto e 4 em simultâneo. Cada resposta 429 inclui um cabeçalho retry-after, e os SDKs da OpenAI e da Anthropic esperam esse tempo e voltam a tentar por conta própria. Num ciclo seu, aguarde os segundos indicados ou reduza a concorrência.
O modelo está indisponível neste momento: Um 404 que indica que o modelo não está disponível neste momento significa que ele está brevemente em baixo no fornecedor de origem, e não um problema com a sua chave ou saldo. Tente novamente daqui a pouco ou envie o pedido para outro modelo.
Recebo um 502 ou 503: Uma falha transitória na origem ou na configuração, sem qualquer cobrança no seu saldo. Repita o pedido; se continuar a falhar, contacte-nos através da loja e vamos analisar.

O que não funciona através da AIGROW

As ferramentas alojadas, como WebSearchTool e FileSearchTool, que a OpenAI oferece apenas na Responses API. As ferramentas de função que escrever são executadas no seu próprio código e funcionam.
Traces no painel da OpenAI sem uma chave da OpenAI. O envio precisa de uma chave de platform.openai.com, definida com set_tracing_export_api_key.
Campos que só a Responses API reconhece, como previous_response_id e conversation_id. Em chat completions, o SDK ignora-os sem apresentar qualquer erro.
Pesquisa web em tempo real dentro do modelo. Uma ferramenta de pesquisa web enviada num pedido é respondida com o que o modelo já sabe, sem resultados em tempo real. Uma ferramenta que obtém páginas na sua própria máquina continua a funcionar.
Qualquer endpoint além destes três: /v1/messages, /v1/chat/completions e /v1/models. A Responses API, os embeddings e a contagem de tokens respondem 404.
Campos de router como models, route, provider e plugins. São descartados, por isso um pedido vai sempre para o único modelo que indica.

Quanto custa um mês de OpenAI Agents SDK

O OpenAI Agents SDK é faturado por token às taxas de crédito da lista de preços. Um agente volta a enviar a conversa inteira a cada passo, por isso uma tarefa longa custa mais do que a última mensagem sugere; o registo de atividade em Acesso à API mostra quanto custou cada pedido.

Perguntas sobre o OpenAI Agents SDK e uma API personalizada

O OpenAI Agents SDK pode usar outro fornecedor?: Sim, qualquer endpoint que use o protocolo da OpenAI. Passe um cliente AsyncOpenAI com base_url https://aigrow.gg/v1 e a sua chave para set_default_openai_client, e chame set_default_openai_api("chat_completions").
Porque é que o Agents SDK devolve um erro 404 com um base URL personalizado?: Por predefinição, chama a Responses API, e o endpoint só disponibiliza chat completions. set_default_openai_api("chat_completions") ou OpenAIChatCompletionsModel resolvem a situação.
O que faz o tracing sem uma chave da OpenAI?: O tracing vem ativado por predefinição e envia cada execução para a OpenAI com a mesma chave das chamadas ao modelo, pelo que, com uma chave da AIGROW, o envio falha com um erro de tracing 401. Desative-o com set_tracing_disabled(True) ou OPENAI_AGENTS_DISABLE_TRACING=1, ou indique-lhe uma chave da OpenAI com set_tracing_export_api_key.
Um agente pode funcionar com um modelo Claude?: Sim. O endpoint disponibiliza modelos Claude no protocolo da OpenAI, pelo que model="claude-opus-5.5" funciona com o cliente do bloco, sem adaptador para instalar.

Fontes: OpenAI Agents SDK Models · OpenAI Agents SDK Configuration · OpenAI Agents SDK Tracing · OpenAI Agents SDK Tools. Consultado em 21 de outubro de 2026.

Configurar outra ferramenta

Claude CodeProtocolo Anthropic
Quatro variáveis de ambiente, na shell ou no settings.json.
ClineProtocolo OpenAI
O fornecedor OpenAI Compatible, quatro campos no ecrã de definições.
Roo CodeProtocolo OpenAI
O fornecedor OpenAI Compatible, os mesmos campos do Cline.
Kilo CodeProtocolo OpenAI
Um fornecedor personalizado no separador Providers; a lista de modelos preenche-se sozinha.
ContinueProtocolo OpenAI
Uma entrada models no config.yaml, com provider openai e um apiBase.
AiderProtocolo OpenAI
OPENAI_API_BASE e OPENAI_API_KEY, depois openai/ antes do ID do modelo.
OpenCodeProtocolo OpenAI
Um bloco provider no opencode.json e a chave através de /connect.
ZedProtocolos Anthropic e OpenAI
Um fornecedor compatível com Anthropic para Claude, um compatível com OpenAI para GPT e Grok.
GooseProtocolo OpenAI
O fornecedor OpenAI com OPENAI_HOST, ou um ficheiro de fornecedor personalizado.
Vercel AI SDKProtocolos Anthropic e OpenAI
O fornecedor OpenAI Compatible para todos os modelos, ou o fornecedor Anthropic para o Claude.
LangChainProtocolos Anthropic e OpenAI
ChatOpenAI com base_url para todos os modelos, ou ChatAnthropic para o Claude.

O guia da API inclui os SDKs, o curl, os endpoints e os limites de utilização.

Cole o bloco e o OpenAI Agents SDK passa a funcionar com o seu crédito.

Compre um pacote de crédito, resgate o código do seu email em Acesso à API, crie uma chave e coloque-a no lugar de ag_your_key_here.

Comprar crédito de API Ver preços e modelos