Empezar con una sola frase
Envía esta frase a tu agente de IA: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
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: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):/.well-known/skills/aihubmix-playground/SKILL.md y puede instalarse desde el repositorio de GitHub con npx skills add AIhubmix/skills. Para escenarios de integración, usa la AIHubMix API Skill.
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": "..."};draftrellena el cuadro de entrada sin enviarlo
Generación de código
El paquete npm@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 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 entornoAIHUBMIX_API_KEY, que puede crearse en la consola. 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