Generación de Video con Sora
Genera videos con IA a través de la API de Sora de OpenAI de AceDataCloud.
Configuración: Consulta autenticación para configurar el token.
Inicio Rápido
curl -X POST https://api.acedata.cloud/sora/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "un golden retriever corriendo en una playa al atardecer", "model": "sora-2", "callback_url": "https://api.acedata.cloud/health"}'
Asíncrono: Consulta sondeo de tareas asíncronas. Sondea mediante
POST /sora/taskscon{"id": "..."}.
Modelos
| Modelo | Duración | Calidad | Mejor para |
|---|---|---|---|
sora-2 | 10–15s | Estándar | La mayoría de tareas (predeterminado) |
sora-2-pro | 10–25s | Más alta | Calidad premium, videos más largos |
Flujos de Trabajo
1. Texto a Video
POST /sora/videos
{
"prompt": "una calle concurrida de Tokio de noche con letreros de neón reflejándose en charcos de lluvia",
"model": "sora-2",
"size": "small",
"duration": 10,
"orientation": "landscape"
}
2. Imagen a Video
Usa imágenes de referencia para guiar la generación.
POST /sora/videos
{
"prompt": "la escena cobra vida gradualmente con un movimiento suave",
"image_urls": ["https://example.com/scene.jpg"],
"model": "sora-2",
"orientation": "landscape"
}
3. Video Controlado por Personaje
Extrae un personaje de un video existente y úsalo en una nueva escena.
POST /sora/videos
{
"prompt": "el personaje camina por una ciudad futurista",
"character_url": "https://example.com/source-video.mp4",
"character_start": 2.0,
"character_end": 5.0,
"model": "sora-2-pro"
}
Parámetros
| Parámetro | Valores | Descripción |
|---|---|---|
model | "sora-2", "sora-2-pro" | Modelo a usar (obligatorio) |
size | "small", "large" | Resolución del video |
duration | 10, 15, 25 | Duración en segundos (25 solo con sora-2-pro) |
orientation | "landscape" (16:9), "portrait" (9:16), "square" (1:1) | Orientación del video |
version | "1.0" | Versión de la API — la versión 1.0 permite hasta 25s de duración, orientación, referencias de personajes e imágenes de entrada |
Advertencias
- La duración de 25 segundos solo está disponible con el modelo
sora-2-pro size: "large"produce mayor resolución pero cuesta más y tarda más- La generación controlada por personaje requiere las marcas de tiempo
character_startycharacter_end(en segundos) del video fuente orientationdefine la relación de aspecto — usa"portrait"para contenido enfocado en móviles- Los estados de tarea usan
"succeeded"(no "completed") — verifica este valor al sondear
MCP:
pip install mcp-sora| Alojado:https://sora.mcp.acedata.cloud/mcp| Consulta todos los servidores MCP