Rode o AutoGPT em uma base URL OpenAI personalizada.
Updated 2026-07-30
O AutoGPT Classic lê OPENAI_API_BASE_URL do seu .env e a passa direto para o cliente OpenAI como base_url. Aponte-a para https://api.apisrouter.com/v1, defina uma chave, e o tráfego SMART_LLM e FAST_LLM do agente roteia por um único endpoint medido.
Resposta rápida: duas linhas no .env.
O .env.template do AutoGPT Classic documenta OPENAI_API_BASE_URL como "URL personalizada para a API da OpenAI, útil para conectar a backends personalizados", e o código do provedor a conecta diretamente ao cliente: a classe OpenAICredentials lê api_base dessa variável e a passa como base_url. Então a sobrescrita é descomentar uma linha e definir a chave: OPENAI_API_BASE_URL para https://api.apisrouter.com/v1 e OPENAI_API_KEY para sua chave do gateway. Uma nota de escopo antes de tudo: isso se aplica ao AutoGPT Classic, o agente autônomo que vive em classic/original_autogpt no repositório. A AutoGPT Platform mais nova do repositório (o construtor visual) gerencia credenciais de modelo por bloco através do próprio backend dela, e essa variável de ambiente não é como você a configura.
OPENAI_API_BASE_URL=https://api.apisrouter.com/v1
OPENAI_API_KEY=sk-APIsRouter-...
SMART_LLM=gpt-5.4
FAST_LLM=gpt-5.4-miniComo o AutoGPT Classic roteia chamadas de modelo.
O AutoGPT (Significant-Gravitas no GitHub, cerca de 185 mil estrelas, o repositório de agente mais estrelado que existe) foi pioneiro no loop autônomo: o agente planeja, escolhe uma ação, a executa, avalia o resultado, e repete até que o objetivo esteja cumprido ou o orçamento não esteja. O Classic divide seu uso de modelo em dois slots. SMART_LLM carrega os turnos de raciocínio principal do agente, e FAST_LLM cuida do trabalho mais leve; os padrões vivem na config como valores de enum, sobrescrevíveis a partir do ambiente. A mecânica de roteamento é incomumente limpa para um projeto dessa idade: OpenAICredentials.api_base é UserConfigurable a partir de OPENAI_API_BASE_URL, e get_api_access_kwargs() a entrega ao cliente OpenAI como base_url. Toda requisição do provedor OpenAI que o agente faz, turnos de planejamento, decisões de uso de ferramenta, resumos, vai para qualquer host que essa variável nomeie. A restrição que separa o AutoGPT de ferramentas de texto livre: SMART_LLM e FAST_LLM são tipados como enums ModelName, validados contra o registro de modelos compilado no agente, não strings livres. O registro das builds recentes cobre a série GPT-5 até gpt-5.4 junto com as famílias 4.1, 4o, e o-series, mas a regra prática é escolher entre nomes que o enum do seu checkout de fato contém. O gateway então recebe exatamente esse id, então o id também precisa existir no catálogo; gpt-5.4 e gpt-5.4-mini satisfazem os dois lados hoje.
Configuração completa: .env no diretório certo, modelos do registro.
Copie .env.template para .env dentro de classic/original_autogpt, descomente e defina os quatro valores, e rode o agente a partir daquele diretório. O .env é carregado relativo ao layout de trabalho do agente classic, então um arquivo lindamente configurado na raiz do repositório não faz nada por ele. A seleção de modelo é uma busca no registro, não uma passagem direta. Definir SMART_LLM para um id que o enum não contém falha a validação na inicialização, antes de qualquer requisição ser feita, o que ao menos falha em voz alta. O corolário é que ids Claude não são endereçáveis por esse caminho de forma alguma: o Classic tem um provedor Anthropic nativo separado (ANTHROPIC_API_KEY) para aqueles nomes de enum, e esse provedor não lê OPENAI_API_BASE_URL. Se seu objetivo é uma chave por um endpoint, mantenha os dois slots em nomes do registro OpenAI que o gateway serve. A disciplina de orçamento ainda se aplica. O loop autônomo é famoso por gastar tokens em rajadas sem supervisão, e redirecioná-lo não muda isso; torna isso mensurável. As próprias configurações de orçamento do Classic continuam valendo a pena definir, e a visão de uso por chave dá a você o livro-razão externo por execução.
cd classic/original_autogpt
cp .env.template .env
# edite o .env:
# OPENAI_API_BASE_URL=https://api.apisrouter.com/v1
# OPENAI_API_KEY=sk-APIsRouter-...
# SMART_LLM=gpt-5.4
# FAST_LLM=gpt-5.4-mini
./autogpt.sh run # ou: poetry run autogpt runEscolhendo SMART_LLM e FAST_LLM.
A comparação honesta é por objetivo, não por chamada: dê ao agente o mesmo objetivo sob duas escolhas de SMART_LLM e compare tokens totais e qualidade do resultado no log de uso. Agentes autônomos são a única carga de trabalho onde o modelo mais forte regularmente vence em custo total.
- SMART_LLM é o julgamento do agente. Ele decide o que fazer a seguir em toda iteração do loop, e uma decisão ruim não só desperdiça uma chamada, ela gera uma subárvore de chamadas desperdiçadas. gpt-5.4 é o par mais forte de registro-e-catálogo para esse slot hoje.
- FAST_LLM absorve o volume mecânico. gpt-5.4-mini mantém as chamadas de apoio do loop numa fração pequena do preço do slot inteligente, o que importa porque execuções autônomas multiplicam tudo.
- Resista à tentação de rodar FAST_LLM como o slot inteligente para economizar: o loop autônomo acumula qualidade de decisão, então um planejador mais fraco geralmente custa mais em tokens totais do que economiza por chamada.
- Nomes de registro mudam com o checkout. Depois de puxar uma versão nova, reverifique se os nomes que você configurou ainda validam; uma renomeação de enum falha na inicialização com um erro claro, o que é melhor que um fallback silencioso.
Pague pelo uso · abaixo do preço oficial
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| Modelo | Preço oficial | Nosso preço |
|---|---|---|
| GPT-5.4 | $2.50 / $15.00 per M | $2.00 / $12.00 per M |
| GPT-5.4 mini | $0.75 / $4.50 per M | $0.60 / $3.60 per M |
| GPT-5.5 | $5.00 / $30.00 per M | $4.00 / $24.00 per M |
| GPT-5.6 Sol | $5.00 / $30.00 per M | $4.00 / $24.00 per M |
Os modos de falha específicos do AutoGPT.
A armadilha do nome de variável. Três ferramentas diferentes usam três grafias diferentes: o mem0 lê OPENAI_BASE_URL, o Aider lê OPENAI_API_BASE, e o AutoGPT Classic lê OPENAI_API_BASE_URL. Memória muscular de outra ferramenta deixa a variável errada definida, o AutoGPT a ignora silenciosamente, e as requisições continuam fluindo para api.openai.com em qualquer coisa que OPENAI_API_KEY contenha. Requisições não aparecendo no seu log de uso do gateway significa verificar isso primeiro. Rejeição de enum na inicialização. SMART_LLM ou FAST_LLM definidos para um id fora do registro compilado falha a validação antes do agente rodar. Esse é o comportamento correto, mas surpreende quem vem de ferramentas de texto livre onde qualquer string é encaminhada; o erro significa "escolha um nome do registro", não "o endpoint está fora do ar". Nomes Claude roteando nativamente. Nomes de enum Anthropic passam pelo provedor Anthropic e ANTHROPIC_API_KEY, ignorando OPENAI_API_BASE_URL. Se você esperava toda requisição em um log de uso e vê só algumas, o tráfego faltante está em um caminho de provedor nativo. O .env errado. O agente classic carrega o .env do próprio diretório dele. Um arquivo na raiz do repositório, ou uma exportação de shell ofuscada por um valor .env obsoleto, produz estados confusos e meio configurados. Mantenha os quatro valores em um lugar: classic/original_autogpt/.env. Expectativas da Platform. Os blocos da AutoGPT Platform gerenciam credenciais no próprio backend deles; definir essa variável de ambiente não os redireciona. O caminho desta página é o do Classic.
Quem roteia o AutoGPT por um gateway.
- Desenvolvedores ressuscitando o Classic para experimentos autônomos que querem o notório apetite por tokens do loop em um livro-razão medido, por chave, desde a primeira execução.
- Curiosos rodando objetivos longos sem supervisão, onde visibilidade por requisição sobre o que o agente realmente fez com seu orçamento importa tanto quanto o total.
- Times padronizando um endpoint entre muitas ferramentas, onde o AutoGPT é mais um .env apontado para a mesma chave em vez de uma conta separada.
- Usuários combinando o julgamento do gpt-5.4 com o volume do gpt-5.4-mini, precificado por token sem assinatura vinculada a nenhum dos dois slots.
- Desenvolvedores sem acesso ao faturamento de um determinado fornecedor. O acesso baseado em recarga sem exigência de cartão remove a dependência de cadastro por provedor.
Verifique o endpoint e depure a primeira execução.
Confirme que o gateway serve exatamente os ids que você colocou em SMART_LLM e FAST_LLM; o agente envia essas strings ao pé da letra. A escada da primeira execução: um erro de validação nomeando seu modelo na inicialização significa que o id não está no registro da sua build, então escolha outro nome de registro. Um 401 significa que OPENAI_API_KEY no próprio .env do agente classic não é a chave do gateway. Um erro model-not-found do gateway significa que o nome de registro que você escolheu não está no catálogo; alinhe os dois lados. E uma execução que funciona mas nunca aparece no log de uso significa que a variável da base URL está com erro de digitação ou no arquivo errado, e o tráfego está indo para o host padrão. Assim que o loop está rodando, observe a visão por requisição durante o primeiro objetivo em vez de depois dele. Agentes autônomos revelam seu comportamento de tokens nos primeiros minutos, e pegar um loop descontrolado cedo vale mais do que qualquer diferença de preço por token.
curl -s https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer $OPENAI_API_KEY" | head -50Perguntas frequentes
Qual variável de ambiente define uma base URL personalizada para o AutoGPT?
OPENAI_API_BASE_URL, no .env do agente classic. Está documentada em .env.template como uma URL personalizada para conectar a backends compatíveis com OpenAI, e o provedor a passa ao cliente OpenAI como base_url. Note a grafia: ela difere das variáveis que outras ferramentas usam.
O AutoGPT Classic pode rodar modelos Claude por essa base URL?
Não. SMART_LLM e FAST_LLM validam contra o registro de modelos compilado do AutoGPT, e nomes Anthropic roteiam pelo provedor Anthropic nativo separado, que não lê OPENAI_API_BASE_URL. Para uma chave por um endpoint, mantenha os dois slots em nomes do registro OpenAI que o gateway serve.
Para que SMART_LLM e FAST_LLM podem ser definidos?
Nomes do enum ModelName no seu checkout: builds recentes cobrem a série GPT-5 até gpt-5.4 mais as famílias 4.1, 4o, e o-series. Strings desconhecidas falham a validação na inicialização. gpt-5.4 e gpt-5.4-mini são escolhas sólidas que existem tanto no registro quanto no catálogo.
Essa configuração também se aplica à AutoGPT Platform?
Não. A Platform (a metade construtor visual do repositório) gerencia credenciais de modelo por bloco no próprio backend dela. OPENAI_API_BASE_URL configura o AutoGPT Classic, o agente autônomo em classic/original_autogpt.
Ainda preciso de uma conta OpenAI depois de definir a base URL?
Não. Com OPENAI_API_BASE_URL apontando para o gateway, OPENAI_API_KEY contém sua chave do gateway e nenhuma requisição vai para hosts da OpenAI. Os nomes das variáveis são históricos; as credenciais são o que quer que o endpoint por trás da base URL aceite.
Quanto custa uma execução do AutoGPT?
É a carga de trabalho menos previsível desta lista: o loop decide sua própria contagem de chamadas, então o custo escala com a dificuldade do objetivo e a frequência com que o agente revisa seu plano. Configure os controles de orçamento do agente, observe a visão de uso por chave ao vivo durante execuções iniciais, e trate os totais de tokens por objetivo como a métrica.