BAI-32/visioncraft-skill

VisionCraft

Genera imágenes y vídeos a través de las APIs de Agnes AI. Ejecuta scripts de PowerShell en scripts/. La clave de API se lee de la variable de entorno AGNES_API_KEY.

¿Primera vez? Consulta los Requisitos previos. Para consejos sobre cómo escribir prompts y detalles de parámetros, mira references/.

Referencia rápida

Tarea	Comando
Texto a imagen	scripts/gen_image.ps1 -Prompt "..."
Imagen a imagen	scripts/gen_image.ps1 -Prompt "..." -ImageUrl "https://..."
Texto a vídeo	scripts/gen_video.ps1 -Prompt "..."
Imagen a vídeo	scripts/gen_video.ps1 -Prompt "..." -Image "https://..."
Vídeo con múltiples imágenes	scripts/gen_video.ps1 -Prompt "..." -Image "https://a.png","https://b.png"
Animación por fotogramas clave	scripts/gen_video.ps1 -Prompt "..." -Image "https://a.png","https://b.png" -Mode keyframes

Valores por defecto: Imágenes 2048x2048. Vídeos 1920x1080 @ 60fps, 241 fotogramas (~4s).

Requisitos previos

Configura la clave de API una sola vez (persiste entre sesiones):

[System.Environment]::SetEnvironmentVariable("AGNES_API_KEY", "sk-your-key-here", "User")

O solo para la sesión actual:

$env:AGNES_API_KEY = "sk-your-key-here"

Verifica con echo $env:AGNES_API_KEY.

Cómo usar esta habilidad

1. Identificar la solicitud

El usuario dice	Modo
"crea/dibuja/genera una imagen de..."	Texto a imagen
"edita/transforma/cambia el estilo de esta imagen..." (URL proporcionada)	Imagen a imagen
"haz un vídeo / anima / genera un clip de..."	Texto a vídeo
"anima esta foto / haz que esta imagen se mueva" (1 imagen)	Imagen a vídeo
"combina estas imágenes en un vídeo" (varias imágenes)	Vídeo con múltiples imágenes
"transición suave / transforma de A a B" (2+ imágenes)	Animación por fotogramas clave

2. Refinar el prompt si es necesario

Si la solicitud es vaga, sugiere brevemente un prompt más completo antes de ejecutar. Para la estructura del prompt y mejores prácticas, consulta references/prompt-guide.md.

3. Ejecutar el script

Pasa la relación de aspecto con -Ratio y la duración con -Seconds para el control más sencillo. Consulta references/parameters.md para todos los parámetros.

# Ejemplos:
scripts/gen_image.ps1 -Prompt "..." -Ratio 16:9
scripts/gen_video.ps1 -Prompt "..." -Ratio 9:16 -Seconds 8

4. Mostrar el resultado

Los scripts imprimen una línea MEDIA:<url> al tener éxito. Siempre muestra la URL en su propia línea — nunca la sepultes en un párrafo. Si la plataforma soporta renderizado de medios en línea, incrústalo; de lo contrario, la URL sola es suficiente.

Nunca descargues el resultado al disco local a menos que el usuario lo solicite explícitamente.

Formato de salida

Imagen:

✅ Imagen generada.

MEDIA:https://platform-outputs.agnes-ai.space/images/...

Vídeo:

🎬 Vídeo generado (4.0s, 1920x1080).

MEDIA:https://platform-outputs.agnes-ai.space/videos/...

Errores y solución de problemas

Error	Solución
AGNES_API_KEY not set	Configúrala (consulta Requisitos previos). Reinicia la terminal si es necesario.
401 No autorizado	La clave de API no es válida o ha caducado.
400 Solicitud incorrecta	Verifica el prompt, el formato del tamaño, la regla del número de fotogramas (8n+1, ≤441).
503 Servicio no disponible	El servicio está ocupado. Espera 30s y reintenta.
Tiempo de espera de vídeo (15 min)	El script imprime el video_id — consúltalo más tarde, la tarea no está abandonada.

Para el comportamiento completo de la API, consulta references/api_docs.md.

Archivos de referencia

• references/api_docs.md — especificación completa de la API de Agnes
• references/prompt-guide.md — estructura del prompt tanto para imagen como para vídeo
• references/parameters.md — todos los parámetros del script, con ejemplos