Crea attività di generazione
Valida l'input, deduce i crediti, crea un'attività e restituisce taskId.
Parametri del payload
- model: Obbligatorio. Uno tra: sora-2-text-to-video, sora-2-image-to-video, sora-2-text-to-video-stable, sora-2-image-to-video-stable, sora-2-pro-text-to-video, sora-2-pro-image-to-video, sora-2-pro-storyboard.
- prompt: Condizionale. Obbligatorio per tutti i modelli eccetto sora-2-pro-storyboard.
- imageData: Condizionale. URL dati Base64 come data:image/png;base64,... Obbligatorio per image-to-video se non c'è imageUrl.
- imageUrl: Condizionale. URL immagine pubblico usato quando imageData non è fornito.
- aspectRatio: Opzionale. portrait o landscape. Default: landscape.
- nFrames: Opzionale. 10, 15 o 25 (solo storyboard). I valori predefiniti variano per modello.
- size: Opzionale. standard o high. Solo per modelli Pro text/image.
- removeWatermark: Opzionale. Rimuove la filigrana per i modelli non-storyboard. Default: true.
- isPublic: Opzionale. Se visualizzare il video pubblicamente; il valore predefinito è true.
- shots: Condizionale. Obbligatorio per sora-2-pro-storyboard. Array di '{ Scene, duration }'.
Note
- imageData ha la precedenza su imageUrl quando entrambi sono forniti.
- prompt è opzionale per storyboard e non viene inviato al provider; usa shots per il contenuto.
- nFrames viene normalizzato ai valori consentiti per modello.
- removeWatermark è impostato su true di default per i modelli non-storyboard.
- shots deve includere Scene (S maiuscola) e duration > 0.
Richieste di esempio
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,
"isPublic": 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-stable",
"prompt": "Turn this image into a dynamic 15s clip.",
"imageData": "data:image/png;base64,iVBORw0KGgoAAA...",
"aspectRatio": "portrait",
"nFrames": "15"
}'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"
}'Risposta di esempio
{
"code": 0,
"message": "ok",
"data": {
"taskId": "281e5b0*********************f39b9"
}
}