Создание задачи генерации
Валидация входных данных, списание кредитов, создание задачи и возврат taskId.
Параметры запроса
- Обязательно. Одно из: 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.
- Условно. Обязательно для всех моделей, кроме sora-2-pro-storyboard.
- Условно. Base64 data URL вида data:image/png;base64,... Обязательно для image-to-video, если нет imageUrl.
- Условно. Публичный URL изображения, используется когда imageData не указан.
- Необязательно. portrait или landscape. По умолчанию: landscape.
- Необязательно. 10, 15 или 25 (только для раскадровки). Значения по умолчанию зависят от модели.
- Необязательно. standard или high. Только для Pro моделей текст/изображение.
- Необязательно. Удалить водяной знак для моделей без раскадровки. По умолчанию: true.
- Условно. Обязательно для sora-2-pro-storyboard. Массив '{ Scene, duration }'.
Примечания
- imageData имеет приоритет над imageUrl, когда указаны оба параметра.
- prompt необязателен для раскадровки и не отправляется провайдеру; используйте shots для контента.
- nFrames нормализуется до допустимых значений для каждой модели.
- removeWatermark по умолчанию true для моделей без раскадровки.
- shots должен включать Scene (с заглавной S) и duration > 0.
Примеры запросов
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
}'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"
}'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"
}'Пример ответа
{
"code": 0,
"message": "ok",
"data": {
"taskId": "281e5b0*********************f39b9"
}
}