> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración para agentes

> Todas las entradas de integración de AIHubMix para agentes de IA: instrucciones de integración agents.md, índice legible por máquinas llms.txt, guía de llamada llms.txt por modelo, Playground Skill y enlaces profundos al Playground. Cada entrada incluye un comando copiable.

AIHubMix ofrece un conjunto de entradas de integración legibles por máquinas para agentes de IA (asistentes de programación como Claude Code, Codex, Cursor y Cline). El agente puede completar por sí mismo el descubrimiento de modelos, la generación de llamadas, la verificación de conectividad e incluso entregarte un enlace al Playground ya configurado. Esta página reúne todas las entradas, cada una con un comando copiable.

## Empezar con una sola frase

Envía esta frase a tu agente de IA:

```text theme={null}
Fetch https://aihubmix.com/agents.md and follow it.
```

`agents.md` es una guía de integración escrita para que el agente la ejecute directamente: comprobar la API Key, elegir un modelo del catálogo en tiempo real, llamar según el protocolo, verificar de extremo a extremo, e incluye una tabla de resolución de problemas.

## Resumen de entradas

| Entrada                                         | Dirección                                                   | Uso                                                                                                                                              |
| ----------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Instrucciones de integración para agentes       | `https://aihubmix.com/agents.md`                            | Guía paso a paso para que el agente complete por sí mismo la integración y la verificación                                                       |
| Índice legible por máquinas del sitio           | `https://aihubmix.com/llms.txt`                             | Índice legible por LLM de las capacidades y la documentación de todo el sitio                                                                    |
| Índice legible por máquinas de la documentación | `https://docs.aihubmix.com/llms.txt`                        | Índice completo de las páginas del sitio de documentación; añade `.md` a la URL de cualquier página de documentación para obtener el texto plano |
| Guía de llamada por modelo                      | `https://aihubmix.com/model/{model_id}/llms.txt`            | Precios, capacidades verificadas, endpoints de protocolo y ejemplos ejecutables de un modelo concreto                                            |
| Playground Skill                                | `https://aihubmix.com/skills/playground`                    | Archivo de skill para agentes para probar modelos, ajustar parámetros, comparar modelos y generar contenido multimedia                           |
| Catálogo de modelos en tiempo real              | `https://aihubmix.com/api/v1/models?type=llm&sort_by=order` | JSON sin autenticación, con precios y metadatos                                                                                                  |

## llms.txt por modelo

Cada modelo tiene una guía de llamada legible por máquinas, con precios, lista de capacidades verificadas, endpoints de protocolo compatibles y ejemplos ejecutables:

```bash theme={null}
curl -s https://aihubmix.com/model/gemini-3.7-flash/llms.txt
```

La pestaña `llms.txt` de la página de detalle del modelo abre directamente el archivo correspondiente. Los modelos cuya verificación aún no se ha completado devuelven un documento orientativo que remite al catálogo en tiempo real y al schema de parámetros, sin declaraciones de capacidades no verificadas.

## Playground Skill

Entrega a tu agente las capacidades del Playground (prueba de modelos, ajuste de parámetros, comparación con el mismo prompt, generación de imagen y video, relevo mediante enlaces profundos):

```text theme={null}
Run curl -fsSL https://aihubmix.com/skills/playground and follow it.
```

La skill también se publica en `/.well-known/skills/aihubmix-playground/SKILL.md` y puede instalarse desde el [repositorio de GitHub](https://github.com/AIhubmix/skills) con `npx skills add AIhubmix/skills`. Para escenarios de integración, usa la [AIHubMix API Skill](/es/skills).

## Enlaces profundos al Playground

El agente puede generar enlaces directos para que retomes en el navegador una sesión del Playground ya configurada:

* Comparación multimodelo: `https://playground.aihubmix.com/?models=gemini-3.7-flash,claude-opus-4-1` (hasta 6)
* Acceso directo a una configuración: `https://playground.aihubmix.com/?config=<JSON codificado en base64url>`, con un JSON de la forma `{"model": "...", "proto": "chat", "params": {...}, "system": "...", "draft": "..."}`; `draft` rellena el cuadro de entrada sin enviarlo

Los parámetros del enlace son de un solo uso: se eliminan de la barra de direcciones al cargar la página y no transportan ninguna clave.

## Generación de código

El paquete npm [`@aihubmix/codegen`](https://www.npmjs.com/package/@aihubmix/codegen) ofrece generación programática de código para 4 protocolos y 7 lenguajes; el cuerpo de solicitud que construye es idéntico al que envía realmente el Playground. [`@aihubmix/model-schema`](https://www.npmjs.com/package/@aihubmix/model-schema) convierte el schema de parámetros en entrada para codegen.

## Preguntas frecuentes

### ¿Cómo verifica el agente que la integración funciona?

`agents.md` incluye pasos de verificación de extremo a extremo: enviar una solicitud mínima que exige una respuesta exacta y comprobar el cuerpo de la respuesta y el eco del modelo. Un HTTP 200 no equivale a éxito; hay que comprobar el contenido de la respuesta.

### ¿Qué credenciales se necesitan para llamar?

Una API Key de AIHubMix, pasada mediante la variable de entorno `AIHUBMIX_API_KEY`, que puede crearse en la [consola](https://console.aihubmix.com/token). No escribas la Key en código, scripts ni conversaciones.

### ¿Qué modelos cubre el llms.txt por modelo?

Los modelos verificados devuelven documentación completa (la lista de capacidades procede de datos verificados oficialmente); el resto de modelos devuelve un documento orientativo. La cobertura se amplía a medida que avanza la verificación.

### ¿Cuál es el estado actual de la compatibilidad con MCP?

El endpoint MCP ofrece actualmente el servicio de generación de imágenes, con ampliación de capacidades en curso. En esta fase se recomienda usar preferentemente la Skill y agents.md para la integración.

***

Última actualización: 2026-08-20
