El SDK de agentes de OpenAI con una URL base personalizada
Dale al SDK este cliente, cámbialo a chat completions y desactiva el rastreo, y tus agentes funcionarán con modelos Claude, GPT y Grok mediante tu clave de AIGROW.
¿Ya tienes un código? Canjéalo en acceso a la API y después crea una clave.
Python, antes de crear un 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)Cambia ag_your_key_here por una clave de acceso a la API.
Dónde está el ajuste
- Paquete de Python
pip install openai-agents
O un agente a la vez
OpenAIChatCompletionsModel pone a un solo agente en chat completions mediante su propio cliente y deja intactos los valores por defecto del SDK.
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),
)O con variables de entorno
El cliente de OpenAI lee estas dos por sí mismo, y la última desactiva el rastreo. Tu código sigue llamando a set_default_openai_api("chat_completions") antes de la primera ejecución.
export OPENAI_BASE_URL=https://aigrow.gg/v1
export OPENAI_API_KEY=ag_your_key_here
export OPENAI_AGENTS_DISABLE_TRACING=1Qué modelo usar
Escribe el id exactamente como aparece aquí.
- Claude Opus 5.5
claude-opus-5.5 - Es el modelo predeterminado en todos los bloques de esta página y el modelo Claude más barato de aquí por token enviado y recibido. Contexto: 1.000.000 tokens.
- Grok 4.7
grok-4.7 - El precio de salida más bajo de aquí. Su contexto es la mitad que el de los modelos Claude. Contexto: 500.000 tokens.
- GPT-6 Astra
gpt-6-astra - Para un modelo GPT. Cuesta lo mismo por token que Fable y más que Opus. Contexto: 1.050.000 tokens.
- Claude Fable 5.1
claude-fable-5.1 - Cuesta más por token que Opus. Compara ambos en la clasificación de programación antes de cambiar. Contexto: 1.000.000 tokens.
La lista de precios incluye cada id y su tarifa en crédito, los precios de la API de Claude muestran las tarifas oficiales y la clasificación de programación compara los modelos con consultas de código.
Comprueba que funciona
Primero la clave por sí sola y después OpenAI Agents SDK con ella.
La clave
Pide la lista de modelos. Requiere una clave válida y no cuesta nada.
curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"{
"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
Guarda el bloque como check.py, añade tu clave y ejecútalo.
python check.pyreadyCuando falla
Primero los errores de OpenAI Agents SDK y luego las respuestas que el endpoint da a cualquier herramienta.
- 404 en cada ejecución
- El SDK sigue usando la Responses API, su valor por defecto. Llama a set_default_openai_api("chat_completions") antes de la primera ejecución o dale al agente un OpenAIChatCompletionsModel.
- Error 401 del cliente de rastreo
- El rastreo sube cada ejecución a OpenAI con la misma clave que las llamadas al modelo, y una clave de AIGROW no es una clave de OpenAI. set_tracing_disabled(True) lo detiene; set_tracing_export_api_key con una clave de platform.openai.com lo mantiene.
- Mi herramienta muestra un error 401 o de autenticación
- Falta la clave o está mal escrita. Cópiala de nuevo desde Acceso a la API en el panel y asegúrate de enviarla como clave, no como nombre de modelo. Una clave revocada falla igual: crea una nueva y sustitúyela.
- Recibo un 402 o un mensaje sobre el crédito
- Tu saldo está agotado. Abre Acceso a la API en el panel, canjea un código o compra otro paquete y la siguiente solicitud se procesará. No hace falta cambiar nada más.
- Aparece 404 o Unknown model
- El modelo tiene que ser uno de los que sirve el endpoint, por ejemplo claude-opus-5.5. Las grafías propias del proveedor también funcionan (claude-opus-5-5, anthropic/claude-opus-5.5), pero un id con fecha o cualquier modelo fuera del catálogo se rechaza antes de reenviar la solicitud y no se factura nada. Solicita GET /v1/models con tu clave para ver la lista actualizada, o consulta los ids en la lista de precios.
- Las solicitudes se rechazan con un 429
- La capacidad del endpoint la comparten todos los clientes: unas 20 solicitudes por minuto y 4 simultáneas. Cada 429 incluye una cabecera retry-after, y los SDK de OpenAI y Anthropic esperan ese tiempo y reintentan por su cuenta. En un bucle propio, espera los segundos que indica o reduce la concurrencia.
- El modelo no está disponible en este momento
- Un 404 que indica que el modelo no está disponible en este momento significa que el proveedor original ha dejado de responder durante un breve periodo; no es un problema de tu clave ni de tu saldo. Reintenta en unos instantes o envía la solicitud a otro modelo.
- Recibo un 502 o un 503
- Es un fallo transitorio del proveedor o de la configuración, y no se cobra de tu saldo. Reintenta la solicitud; si sigue fallando, escríbenos a través de la tienda y lo revisaremos.
Lo que no funciona a través de AIGROW
Las herramientas alojadas, como WebSearchTool y FileSearchTool, que OpenAI ofrece solo en la Responses API. Las herramientas de función que escribes se ejecutan en tu propio código y funcionan.
Rastreos en el panel de OpenAI sin una clave de OpenAI. La subida necesita una clave de platform.openai.com, definida con set_tracing_export_api_key.
Campos que solo conoce la Responses API, como previous_response_id y conversation_id. En chat completions, el SDK los descarta sin mostrar ningún error.
Búsqueda web en vivo dentro del modelo. Una herramienta de búsqueda web enviada con una solicitud se responde con lo que el modelo ya sabe, sin resultados en vivo. Una herramienta que obtiene páginas en tu propio equipo sigue funcionando.
Cualquier endpoint además de estos tres: /v1/messages, /v1/chat/completions y /v1/models. La Responses API, los embeddings y el recuento de tokens responden 404.
Campos de enrutador como models, route, provider y plugins. Se descartan, de modo que una solicitud siempre va al único modelo que indica.
Cuánto cuesta un mes con OpenAI Agents SDK
OpenAI Agents SDK se factura por token a las tarifas de crédito de la lista de precios. Un agente reenvía toda la conversación en cada paso, así que una tarea larga cuesta más de lo que sugiere su último mensaje; el registro de actividad de acceso a la API muestra lo que costó cada solicitud.
Preguntas sobre OpenAI Agents SDK y una API personalizada
- ¿Puede el OpenAI Agents SDK usar otro proveedor?
- Sí, cualquier endpoint que hable el protocolo de OpenAI. Pasa a set_default_openai_client un cliente AsyncOpenAI con base_url https://aigrow.gg/v1 y tu clave, y llama a set_default_openai_api("chat_completions").
- ¿Por qué el Agents SDK devuelve un 404 con una base URL personalizada?
- Por defecto llama a la Responses API, y el endpoint solo ofrece chat completions. Se cambia con set_default_openai_api("chat_completions") o con OpenAIChatCompletionsModel.
- ¿Qué hace el tracing sin una clave de OpenAI?
- El tracing está activado por defecto y sube cada ejecución a OpenAI con la misma clave que las llamadas al modelo, así que con una clave de AIGROW la subida falla con un error de tracing 401. Desactívalo con set_tracing_disabled(True) o con OPENAI_AGENTS_DISABLE_TRACING=1, o dale una clave de OpenAI con set_tracing_export_api_key.
- ¿Puede un agente funcionar con un modelo de Claude?
- Sí. El endpoint ofrece los modelos de Claude en el protocolo de OpenAI, así que model="claude-opus-5.5" funciona con el cliente del bloque, sin instalar ningún adaptador.
Fuentes: OpenAI Agents SDK Models · OpenAI Agents SDK Configuration · OpenAI Agents SDK Tracing · OpenAI Agents SDK Tools. Consultado el 21 de octubre de 2026.
Configurar otra herramienta
- Claude CodeProtocolo de Anthropic
Cuatro variables de entorno, en la shell o en settings.json.
- ClineProtocolo de OpenAI
El proveedor OpenAI Compatible, cuatro campos en la pantalla de ajustes.
- Roo CodeProtocolo de OpenAI
El proveedor OpenAI Compatible, los mismos campos que en Cline.
- Kilo CodeProtocolo de OpenAI
Un proveedor personalizado en la pestaña Providers; la lista de modelos se rellena sola.
- ContinueProtocolo de OpenAI
Una entrada de models en config.yaml, con provider openai y un apiBase.
- AiderProtocolo de OpenAI
OPENAI_API_BASE y OPENAI_API_KEY, y después openai/ antes del id del modelo.
- OpenCodeProtocolo de OpenAI
Un bloque provider en opencode.json y la clave mediante /connect.
- ZedProtocolos de Anthropic y OpenAI
Un proveedor compatible con Anthropic para Claude y uno compatible con OpenAI para GPT y Grok.
- GooseProtocolo de OpenAI
El proveedor de OpenAI con OPENAI_HOST, o un archivo de proveedor personalizado.
- Vercel AI SDKProtocolos de Anthropic y OpenAI
El proveedor compatible con OpenAI para todos los modelos, o el proveedor de Anthropic para Claude.
- LangChainProtocolos de Anthropic y OpenAI
ChatOpenAI con base_url para todos los modelos, o ChatAnthropic para Claude.
La guía de la API incluye los SDK, curl, los endpoints y los límites de uso.
Pega el bloque y OpenAI Agents SDK funcionará con tu crédito.
Compra un paquete de crédito, canjea el código de tu correo en acceso a la API, crea una clave y ponla en lugar de ag_your_key_here.