Modelflare Media Skill

Modelflare Media Skill es una habilidad de agente instalable: una carpeta con un SKILL.md, una referencia de modelo generada y un script de ayuda. Una vez que está en el directorio de habilidades de su agente, Claude Code, Codex o cualquier agente que lea SKILL.md sabe cómo elegir un modelo de imagen o video de Modelflare, cotizar su precio, enviar la solicitud correcta, esperar videos y guardar el resultado.

El paquete se genera a partir del catálogo de modelos en vivo cada pocos minutos, por lo que la lista de modelos y los precios que contiene nunca quedan obsoletos. Los modelos de texto están intencionalmente fuera de alcance: su agente ya tiene uno. El script auxiliar solo necesita Node.js 18 o posterior, que Claude Code y Codex ya requieren, y se comporta igual en macOS, Windows y Linux.

1. Instalar

No es necesario saber dónde guarda las habilidades su agente; el agente lo hace. Envíale este mensaje, el mismo para todos los agentes:

Install this skill: https://modelflare.dev/skills/modelflare-media/modelflare-media.zip (or use the attached zip), then read its SKILL.md. If you do not support skills, extract it anywhere and follow SKILL.md. My key is in the environment variable MODELFLARE_API_KEY.

Si el agente no puede descargar archivos, descarga el zip tú mismo y adjúntalo al mensaje. Los agentes que soportan habilidades (Claude Code, Codex y otros) lo instalan en su propia ubicación de habilidades; un agente sin un mecanismo de habilidades aún puede leer SKILL.md desde donde extrajo el paquete.

Instalación manual (opcional)

Solo es necesario si prefieres colocar los archivos tú mismo, por ejemplo en una máquina compartida o en CI.

curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

irm https://modelflare.dev/skills/modelflare-media/install.ps1 | iex

Ambos se instalan en ~/.claude/skills/modelflare-media (en Windows es decir %USERPROFILE%\.claude\skills), que Claude Code lee como una habilidad a nivel de usuario; una copia a nivel de proyecto va a .claude/skills/ dentro del repositorio. Para otro agente, configure primero SKILL_DIR en su carpeta de habilidades (consulte la documentación de ese agente para conocer la ruta exacta).

SKILL_DIR=~/.codex/skills curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

$env:SKILL_DIR = "$HOME\.codex\skills"; irm https://modelflare.dev/skills/modelflare-media/install.ps1 | iex

También puedes leer SKILL.md directamente para ver qué seguirá el agente.

2. Entrega una clave a tu agente

Cree una clave API en la consola y configúrela en el entorno en el que se ejecuta su agente. En macOS y Linux, agregue la exportación a su perfil de shell para conservarla; en Windows la segunda línea la hace persistente.

macOS o Linux
Windows PowerShell

export MODELFLARE_API_KEY="sk-..."

$env:MODELFLARE_API_KEY = "sk-..."
setx MODELFLARE_API_KEY "sk-..."

Si no se siente cómodo configurando variables de entorno usted mismo, puede enviar la clave a su propio agente de confianza en una sesión privada y pedirle que configure el entorno por usted. Trate la clave como una contraseña: confirme lo que escribirá el agente y dónde, nunca la envíe a un servicio que no sea de confianza o a un chat, problema, repositorio o ticket público/compartido. Pídale al agente que no repita la clave, que guarde una copia, que la coloque en el código fuente, en las solicitudes, en los registros o en el historial del shell, o que la confirme. Revoca la clave y crea una nueva inmediatamente si crees que puede haber quedado expuesta.

La habilidad nunca escribe la clave en archivos o solicitudes y nunca la imprime. Las cuentas creadas a través de Castaly ya tienen una clave llamada Castaly que se dirige a todos los grupos desbloqueados; cualquier otra clave con grupos de imágenes o vídeos también funciona.

3. Preguntar por medios

Habla con tu agente como siempre:

“Genera un cartel 16:9 de un observatorio costero al anochecer con gpt-image-2.”
“Convierte este fotograma inicial en un vídeo de 1080p de 5 segundos con Seedance”.
“¿Qué modelos de vídeo de menos de 0,10 USD por segundo pueden convertir imagen a vídeo?”

El agente lee SKILL.md, obtiene el catálogo en vivo de https://modelflare.dev/api/pricing para ver qué modelos puede usar la clave y cuánto cuestan, luego abre la propia página de ese modelo en el sitio de documentos para obtener el cuerpo exacto de la solicitud, la tabla de parámetros y los límites, y llama a la API con su propio cliente HTTP. Cada llamada lleva el encabezado X-Modelflare-Skill: modelflare-media/1.0, por lo que los registros de uso muestran qué solicitudes provienen de la habilidad.

4. Desde el banco de trabajo de Castaly

Cada generación en el Castaly workbench tiene un panel “Reproduce esto en tu propio agente” con el mensaje de instalación, el zip y un resumen de la tarea. Envíe el mensaje de instalación una vez, luego pegue el resumen y el agente reproducirá el mismo modelo y parámetros con su propia clave.

Lo que no hace la habilidad

No le dice a su agente cómo trabajar. Los reintentos, el procesamiento por lotes y lo que se debe informar quedan entre usted y su agente; la habilidad solo documenta la API.
No lleva lista de modelos propia. El catálogo y cada contrato solicitado se leen en vivo, por lo que un modelo publicado hoy se puede utilizar hoy.
No carga archivos a ningún almacenamiento: las imágenes de referencia locales están incrustadas en la solicitud como URL de datos, así que manténgalas pequeñas (unos pocos MB).
No puede desbloquear grupos de modelos. Si la API responde model_unavailable, ese modelo no está disponible para esta cuenta.

Diseño del paquete

modelflare-media/
  SKILL.md   authentication, where the live catalog is, how to find each model's
             request contract on the docs site, and what the error codes mean

El paquete no contiene datos del modelo, por lo que no queda obsoleto; reinstálelo solo para obtener una nueva versión de habilidad.