Esta página es una traducción de la documentación en inglés. Los comandos, identificadores y ejemplos no cambian. Runtime 7.24.4 · SDK 2.6.7. Original en inglés

Inicio rápido de API de nivel gratuito

Estado: Activo Alcance: estado actual Última revisión: 2026-08-28 Responsable: runtime de ax-code

AX Code no aporta cuota de modelo. Una ejecución «gratuita» usa la cuota o los créditos que ofrece un proveedor externo de modelos, cuya disponibilidad, límites, condiciones de datos y catálogo de modelos pueden cambiar con independencia de AX Code.

Camino admitido más corto: Groq

Groq es un proveedor predeterminado de AX Code, su catálogo actual de modelos de AX Code contiene modelos capaces de usar herramientas y Groq publica límites del plan gratuito para esos ID de modelo.

1. Crea una cuenta de Groq y una clave de API en la consola de Groq.
2. Guarda la clave en AX Code:

ax-code providers login groq

3. Confirma los modelos disponibles en tu versión instalada de AX Code:

ax-code models groq

4. Abre ax-code, ejecuta /connect y elige Groq y uno de los modelos enumerados. Para una prueba de humo sin interfaz, el catálogo incluido actual admite:

ax-code run --model groq/openai/gpt-oss-120b "Inspect this repository without editing it and summarize its purpose."

Si ax-code models groq no imprime ese modelo exacto, usa un ID de modelo que sí imprima. El catálogo instalado es la autoridad de la versión instalada.

Opciones integradas de nivel gratuito y de crédito gratuito

Estos proveedores están en el selector de configuración predeterminado de AX Code. «Integrado» significa que AX Code aporta el adaptador de protocolo, los metadatos del modelo, el flujo de credenciales y el endpoint del proveedor; no significa que cada modelo o cada solicitud sea gratuita.

Para UnoRouter, conéctate con ax-code providers login unorouter, ejecuta ax-code models unorouter y elige un modelo cuyo ID termine en :free. No supongas que el gemelo de pago sin ese sufijo es gratuito. El propio catálogo de UnoRouter indica que no todos los modelos gratuitos admiten llamadas a herramientas; AX Code solo muestra las entradas capaces de usar herramientas de su catálogo incluido.

Para Google o Hugging Face, conéctate con el ID de proveedor correspondiente y luego usa ax-code models google o ax-code models huggingface. Consulta la página de precios en vivo del proveedor antes de elegir un modelo.

Añadir el enrutador de modelos gratuitos de OpenRouter

OpenRouter documenta openrouter/free como un enrutador de coste cero que elige un modelo gratuito disponible y compatible con la solicitud. Como ese enrutador no está en la instantánea curada actual de AX Code, añade una entrada local conservadora de modelo a ax-code.json en la raíz de tu proyecto (o fusiónala con tu configuración global de AX Code):

{
  "$schema": "https://ax-code.app/docs-assets/schema/config.schema.json",
  "provider": {
    "openrouter": {
      "models": {
        "openrouter/free": {
          "name": "OpenRouter Free Models Router",
          "tool_call": true,
          "limit": {
            "context": 32768,
            "output": 4096,
          },
        },
      },
    },
  },
}

Los límites de arriba son valores conservadores de presupuesto de AX Code, no un derecho de OpenRouter. Luego conecta y verifica el catálogo de modelos fusionado:

ax-code providers login openrouter
ax-code models openrouter
ax-code run --model openrouter/openrouter/free "Inspect this repository without editing it and identify its test command."

El openrouter repetido es intencionado: el primer segmento es el ID de proveedor de AX Code y openrouter/free es el ID de modelo que espera OpenRouter. La disponibilidad y la selección del enrutador gratuito varían según la solicitud; consulta la documentación del enrutador gratuito de OpenRouter.

Cómo usar el catálogo externo de API gratuitas

awesome-free-llm-apis sirve para descubrir ofertas actuales, pero no es una lista de compatibilidad ni de respaldo de AX Code:

• Un proveedor de Proveedores y modelos compatibles tiene un ajuste de configuración predeterminado de AX Code.
• Un proveedor que solo aparece en models-snapshot.json está respaldado por el registro, no necesariamente curado para el flujo de configuración predeterminado.
• Otro servicio puede funcionar mediante Proveedores personalizados y de pasarela cuando expone un endpoint compatible con OpenAI o con Anthropic.
• «Compatible con OpenAI» es necesario, pero no basta para un agente de programación. El modelo elegido también necesita respuestas de texto en flujo y llamadas fiables a herramientas o funciones.
• Los nombres de proveedor, los ID de modelo, las cuotas gratuitas, las regiones y los requisitos de cuenta de las listas de terceros pueden quedar obsoletos. Verifícalos en las páginas oficiales de precios, de modelos y de límites de tasa del proveedor antes de depender de ellos.

En la fecha de revisión de esta página, los servicios que nombra ese catálogo se corresponden con AX Code así:

En particular, el ajuste github-copilot no es la API github-models que enumeran algunos catálogos. No sustituyas un ID de proveedor o un flujo de credenciales por el otro. Las API generales zai y zhipuai empiezan en GLM-5.3; los SKU más antiguos de GLM 3, GLM 4, GLM-5 y GLM-5.2 siguen filtrados.

Prácticas de evaluación segura

• Prueba primero con un repositorio público o desechable. Un proveedor o una pasarela alojados reciben los prompts y el contexto de código enviados a su API.
• Activa el aislamiento workspace-write, o usa read-only para una prueba de humo solo de revisión.
• Empieza con una tarea corta y un agente. Council, arena, las sesiones largas y los repositorios grandes pueden consumir muchas solicitudes y alcanzar pronto los límites del nivel gratuito.
• Guarda las credenciales con ax-code providers login o con una variable de entorno; nunca confirmes claves de API en ax-code.json.
• Trata 429 y la indisponibilidad temporal como restricciones normales del nivel gratuito. Espera la ventana de reintento del proveedor o elige otro modelo gratuito que esté enumerado ahora.