Buat tugas generasi
Validasi input, potong kredit, buat tugas, dan kembalikan taskId.
Parameter payload
- Wajib. Salah satu dari 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.
- Kondisional. Wajib untuk semua model kecuali sora-2-pro-storyboard.
- Kondisional. URL data Base64 seperti data:image/png;base64,... Wajib untuk image-to-video jika tidak ada imageUrl.
- Kondisional. URL gambar publik yang digunakan ketika imageData tidak disediakan.
- Opsional. portrait atau landscape. Default: landscape.
- Opsional. 10, 15, atau 25 (hanya storyboard). Default bervariasi per model.
- Opsional. standard atau high. Hanya untuk model Pro teks/gambar.
- Opsional. Hapus watermark untuk model non-storyboard. Default: true.
- Kondisional. Wajib untuk sora-2-pro-storyboard. Array dari '{ Scene, duration }'.
Catatan
- imageData lebih diutamakan daripada imageUrl ketika keduanya disediakan.
- prompt bersifat opsional untuk storyboard dan tidak dikirim ke provider; gunakan shots untuk konten.
- nFrames dinormalisasi ke nilai yang diizinkan per model.
- removeWatermark default-nya true untuk model non-storyboard.
- shots harus menyertakan Scene (huruf kapital S) dan duration > 0.
Contoh request
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"
}'Contoh response
{
"code": 0,
"message": "ok",
"data": {
"taskId": "281e5b0*********************f39b9"
}
}