Guía de la API

Configura Claude Code, Cline o cualquier SDK con crédito de AIGROW

Una configuración breve y sencilla del endpoint de AIGROW. Canjea tu código, crea una clave, apunta cualquier herramienta compatible con OpenAI o Anthropic a la URL base y envía una solicitud. Sin ningún SDK nuestro que instalar.

Funciona con Claude Code, Cline, Aider, OpenCode, Zed, los SDK de OpenAI y Anthropic, y curl.

El endpoint de la API de AIGROW sustituye directamente a las API de OpenAI y Anthropic. Usa https://aigrow.gg como URL base de Anthropic o https://aigrow.gg/v1 como URL base de OpenAI, autentícate con tu clave ag_ y envía el id exacto del modelo que figura en el catálogo. El crédito se añade al canjear en el panel el código de tu recibo.

Configurarlo con un agente de IA

La mayoría se lo encarga a un agente de programación. Pega el bloque en Claude Code, Cursor, Cline o cualquier agente y se configura solo; después sustituye la clave por una tuya.

AIGROW API gateway: an OpenAI- and Anthropic-compatible endpoint.
Configure a client with ONE of these two wires. The key starts with ag_.

Anthropic wire
  base URL   https://aigrow.gg            (the SDK appends /v1/messages)
  header     x-api-key: ag_your_key_here  (or Authorization: Bearer ag_your_key_here)
  header     anthropic-version: 2023-06-01
  body       max_tokens is required on every request

OpenAI wire
  base URL   https://aigrow.gg/v1         (POST /chat/completions)
  header     Authorization: Bearer ag_your_key_here

Model ids: claude-opus-5.5, claude-fable-5.1, gpt-6-astra, claude-sonnet-5.5, gpt-6.1-sol, grok-4.7
The provider's own spellings work too (claude-opus-5-5, anthropic/claude-opus-5.5).
A date suffix or any other model is rejected with 404 "Unknown model" before
the request is forwarded, and nothing is billed.
Claude Code: also set ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-sonnet-5.5, since its
background calls default to a Haiku model the endpoint does not serve.
Call GET /v1/models with the key for the live list of ids.

Endpoints: POST /v1/messages (Anthropic), POST /v1/chat/completions (OpenAI),
GET /v1/models. Streaming is supported on both wires.
Capacity: about 20 requests per minute and 4 in flight, shared. Past it a
request gets 429 with a retry-after header; wait that long and send it again.
Full guide: https://aigrow.gg/ai-api/guide

Incluye los dos protocolos, los nombres de las cabeceras, la regla del id exacto y los límites, que es justo lo que un agente suele hacer mal al primer intento.

Canjea tu código

Este es el único paso propio de AIGROW. Lleva menos de un minuto.

Inicia sesión en el panelAbre aigrow.gg/dashboard e inicia sesión, o crea una cuenta con cualquier correo electrónico. El código no está vinculado al correo con el que pagaste.1 minuto
Pega tu códigoVe a Acceso a la API, pega el código de tu correo de canje en Canjear un código y tu saldo se actualizará al instante.Instantáneo
Crea una claveSin salir de Acceso a la API, crea una clave. Empieza por ag_ y se muestra una sola vez, así que cópiala directamente en tu herramienta.Se muestra una vez

Lo que necesita toda herramienta

Una URL base y tu clave. Elige la URL base que corresponda a tu herramienta.

URL base de Anthropic

Para Claude Code, Claude Desktop y el SDK de Anthropic.

https://aigrow.gg
URL base de OpenAI

Para Cline, Aider, OpenCode, el SDK de OpenAI y la mayoría de las demás herramientas.

https://aigrow.gg/v1

Envía el id del modelo exactamente como aparece en el catálogo, por ejemplo claude-opus-5.5. La lista de precios recoge todos los ids y su coste, o haz una solicitud GET /v1/models con tu clave para ver la lista actualizada.

Conecta tu herramienta

Cada herramienta tiene su propia página: el bloque exacto, dónde va, qué id de modelo enviar y qué significa cada error.

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

  • OpenAI Agents SDKProtocolo de OpenAI

    Tu propio cliente AsyncOpenAI, cambiado a chat completions y con el rastreo desactivado.

  • LangChainProtocolos de Anthropic y OpenAI

    ChatOpenAI con base_url para todos los modelos, o ChatAnthropic para Claude.

Los SDK y curl

Copia el bloque y sustituye la clave por la tuya.

OpenAI SDK (Python)

Define base_url y api_key al crear el cliente.

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="claude-opus-5.5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Anthropic SDK (Python)

Define base_url y api_key al crear el cliente.

from anthropic import Anthropic

client = Anthropic(
    base_url="https://aigrow.gg",
    api_key="ag_your_key_here",
)

msg = client.messages.create(
    model="claude-opus-5.5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text)

curl (OpenAI)

Una primera solicitud desde la línea de comandos para comprobar que la clave funciona.

curl https://aigrow.gg/v1/chat/completions \
  -H "Authorization: Bearer ag_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5.5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

curl (Anthropic)

La misma solicitud con el protocolo de Anthropic.

curl https://aigrow.gg/v1/messages \
  -H "x-api-key: ag_your_key_here" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5.5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

¿Usas el Vercel AI SDK, el OpenAI Agents SDK o LangChain? Cada uno necesita un ajuste más para seguir en chat completions, y su página incluye el bloque correspondiente.

Endpoints y límites

Las mismas rutas que las API oficiales, con un tope de tráfico compartido.

Endpoints

Envía las solicitudes a estas rutas.

POST /v1/messages          (Anthropic)
POST /v1/chat/completions  (OpenAI)
GET  /v1/models            (list the model ids)
Límites de solicitudes

Compartidos entre todos los usuarios del endpoint.

20 requests / minute
4 requests in flight at once

En el protocolo de Anthropic toda solicitud debe incluir max_tokens. El streaming funciona en ambos protocolos y una solicitud en streaming cuesta exactamente lo mismo que una sin streaming.

Vigila tu crédito

Cada solicitud se factura a la tarifa publicada de su modelo y se descuenta de tu saldo.

La página de Acceso a la API muestra tu saldo, tus claves y un registro de actividad con el modelo y el coste de cada solicitud, así que nunca tienes que adivinar el saldo. Cuando se esté agotando, canjea otro código o compra un paquete: el crédito se suma a la misma cuenta y todas las claves siguen funcionando.

Si algo no funciona

Los pocos problemas con los que suele tropezar la gente y la solución en una línea para cada uno.

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.

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.

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.

En el protocolo de Anthropic (/v1/messages) toda solicitud debe incluir max_tokens. Añádelo, por ejemplo "max_tokens": 512, y la solicitud se procesará. El protocolo de OpenAI no lo exige.

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.

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.

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.

Sí. Las respuestas en streaming pasan directamente tanto por el protocolo de OpenAI como por el de Anthropic, y el uso se mide a partir del stream, así que una solicitud con streaming cuesta lo mismo que una sin él.

Eso es toda la configuración.

Canjea, crea una clave, define la URL base y envía una solicitud. Los mismos modelos, hasta un 75% por debajo del precio de lista.

Compatible con OpenAI y Anthropic · panel de uso incluido · sin permanencia