Crear tarea de generación
Valida la entrada, deduce créditos, crea una tarea y devuelve taskId.
Método: POSTRuta: /api/v1/video/sora-pro
Parámetros del payload
- Requerido. Uno de sora-2-text-to-video, sora-2-image-to-video, sora-2-pro-text-to-video, sora-2-pro-image-to-video, sora-2-pro-storyboard.
- Condicional. Requerido para todos los modelos excepto sora-2-pro-storyboard.
- Condicional. URL de datos Base64 como data:image/png;base64,... Requerido para imagen a video si no hay imageUrl.
- Condicional. URL de imagen pública usada cuando no se proporciona imageData.
- Opcional. portrait o landscape. Por defecto: landscape.
- Opcional. 10, 15 o 25 (solo storyboard). Los valores por defecto varían según el modelo.
- Opcional. standard o high. Solo para modelos Pro texto/imagen.
- Opcional. Eliminar marca de agua para modelos que no son storyboard. Por defecto: true.
- Condicional. Requerido para sora-2-pro-storyboard. Array de '{ Scene, duration }'.
Notas
- imageData tiene prioridad sobre imageUrl cuando se proporcionan ambos.
- prompt es opcional para storyboard y no se envía al proveedor; usa shots para el contenido.
- nFrames se normaliza a los valores permitidos por modelo.
- removeWatermark es true por defecto para modelos que no son storyboard.
- shots debe incluir Scene (S mayúscula) y duration > 0.
Solicitudes de ejemplo
Texto a video
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2-pro-text-to-video",
"prompt": "A cinematic shot of a futuristic city at sunset.",
"aspectRatio": "landscape",
"nFrames": "10",
"size": "high",
"removeWatermark": true
}'Imagen a video
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2-image-to-video",
"prompt": "Turn this image into a dynamic 10s clip.",
"imageUrl": "https://example.com/reference.png",
"aspectRatio": "portrait",
"nFrames": "10"
}'Storyboard
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2-pro-storyboard",
"shots": [
{ "Scene": "Establishing shot of a city skyline at dusk", "duration": 5 },
{ "Scene": "Close-up of a runner splashing through puddles", "duration": 5 }
],
"aspectRatio": "landscape",
"nFrames": "10"
}'Respuesta de ejemplo
{
"code": 0,
"message": "ok",
"data": {
"taskId": "281e5b0*********************f39b9"
}
}