Utwórz zadanie generowania
Zwaliduj dane wejściowe, odejmij kredyty, utwórz zadanie i zwróć taskId.
Parametry ładunku
- Wymagane. Jeden z: 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.
- Warunkowe. Wymagane dla wszystkich modeli z wyjątkiem sora-2-pro-storyboard.
- Warunkowe. URL danych Base64 jak data:image/png;base64,... Wymagane dla image-to-video, jeśli brak imageUrl.
- Warunkowe. Publiczny URL obrazu używany, gdy imageData nie jest podane.
- Opcjonalne. portrait lub landscape. Domyślnie: landscape.
- Opcjonalne. 10, 15 lub 25 (tylko storyboard). Wartości domyślne różnią się w zależności od modelu.
- Opcjonalne. standard lub high. Tylko dla modeli Pro tekst/obraz.
- Opcjonalne. Usuń znak wodny dla modeli innych niż storyboard. Domyślnie: true.
- Warunkowe. Wymagane dla sora-2-pro-storyboard. Tablica '{ Scene, duration }'.
Uwagi
- imageData ma pierwszeństwo przed imageUrl, gdy podane są oba.
- prompt jest opcjonalny dla storyboard i nie jest wysyłany do dostawcy; użyj shots dla treści.
- nFrames jest normalizowane do dozwolonych wartości dla danego modelu.
- removeWatermark domyślnie ustawione na true dla modeli innych niż storyboard.
- shots musi zawierać Scene (wielka litera S) i duration > 0.
Przykładowe żądania
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"
}'Przykładowa odpowiedź
{
"code": 0,
"message": "ok",
"data": {
"taskId": "281e5b0*********************f39b9"
}
}