MiniAPI video, imagen y audio
MiniAPI es una clave API prepagada para modelos de video, imagen y audio en https://api.minicut.ai.
Un modelo marcado como coming soon en models tiene precio pero aún no acepta trabajos; elige otro.
Los precios son por segundo o por imagen, y se fijan antes de ejecutar el trabajo. Los trabajos fallidos no se cobran.
Los créditos nunca caducan.
Script auxiliar (Node 18+, sin instalación): node scripts/miniapi.mjs <comando>, ejecutar desde la carpeta de este skill.
Paso 0. Clave
- Si
MINIAPI_KEYno está configurada, indícale al usuario en una línea: crea una clave en https://api.minicut.ai/console/keys?utm_source=skills-sh&utm_medium=skill&utm_campaign=miniapi-video , agrega fondos (mínimo $10), luegoexport MINIAPI_KEY=mapi_live_.... Espera a que lo haga. - Nunca imprimas la clave. Nunca la escribas en un archivo del proyecto.
Paso 1. Elegir el modelo
Ejecuta node scripts/miniapi.mjs models para ver cada id con su precio inicial.
Ejecuta node scripts/miniapi.mjs model <id> para ver los parámetros, límites y precios de ese modelo.
Usa únicamente los parámetros listados en la página de ese modelo. Un parámetro que el modelo no acepte será rechazado con error 422.
Valores predeterminados cuando el usuario no especifica uno:
| Trabajo | Id del modelo | Motivo |
|---|---|---|
| Video, mejor calidad | seedance-2.5 | 4 a 30 s, hasta 1080p, referencias, sonido activado por defecto |
| Video, borrador barato | seedance-2.0-mini | desde $0.054 / s |
| Imagen | lee models y elige el modelo de imagen que nombre el usuario, si no, el modelo de imagen más barato |
Paso 2. Cotizar, luego preguntar
- Construye el cuerpo JSON a partir de la página del modelo.
- Ejecuta
node scripts/miniapi.mjs quote <id> '<json>'. Una cotización es gratuita y no ejecuta nada. - Muéstrale al usuario la línea PRECIO y pídele un sí. Nunca envíes el trabajo sin eso.
- Un sí cubre un solo trabajo. Una repetición o un segundo clip requiere una nueva cotización y un nuevo sí.
Paso 3. Ejecutar
node scripts/miniapi.mjs run <id> '<json>' --yes --out <carpeta>
Vuelve a cotizar, envía el trabajo, espera, descarga el archivo en <carpeta> e imprime SAVED <ruta> y CHARGED <precio>.
Muéstrale al usuario la ruta guardada. Si es una imagen, ábrela. Si es un clip, da la ruta.
Errores
| Salida | Significado | Acción |
|---|---|---|
| 3 | sin clave | Paso 0 |
| 4 | saldo insuficiente | dile al usuario el precio y el enlace para agregar fondos que se imprimió |
| 5 | MiniAPI rechazó el cuerpo | lee el mensaje, corrige el campo desde la página del modelo, cotiza de nuevo |
| 7 | el trabajo falló | no se cobró. Dilo y ofrece un reintento modificado con una nueva cotización |
Ejemplo
Usuario: "haz un clip de 5 segundos de un zorro rojo corriendo por la nieve al amanecer, 720p"
node scripts/miniapi.mjs quote seedance-2.5 '{"prompt":"un zorro rojo corre por la nieve al amanecer","resolution":"720p","duration":5}'
# PRECIO 1.750000 USD ... La cotización es gratuita. No se ejecutó nada.
# (pregunta al usuario, espera el sí)
node scripts/miniapi.mjs run seedance-2.5 '{"prompt":"un zorro rojo corre por la nieve al amanecer","resolution":"720p","duration":5}' --yes --out clips
Documentación: https://api.minicut.ai/docs . Todos los modelos en Markdown: https://api.minicut.ai/llms.txt