Opprett genereringsoppgave
Valider input, trekk fra kreditter, opprett en oppgave og returner taskId.
Payload-parametere
- model: Påkrevd. En av: 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: Betinget. Påkrevd for alle modeller unntatt sora-2-pro-storyboard.
- imageData: Betinget. Base64 data-URL som data:image/png;base64,... Påkrevd for bilde-til-video hvis ingen imageUrl.
- imageUrl: Betinget. Offentlig bilde-URL brukt når imageData ikke er oppgitt.
- aspectRatio: Valgfritt. portrait eller landscape. Standard: landscape.
- nFrames: Valgfritt. 10, 15 eller 25 (kun storyboard). Standardverdier varierer per modell.
- size: Valgfritt. standard eller high. Kun for Pro tekst/bilde-modeller.
- removeWatermark: Valgfritt. Fjern vannmerke for ikke-storyboard-modeller. Standard: true.
- isPublic: Valgfritt. Om videoen skal vises offentlig; standard er true.
- shots: Betinget. Påkrevd for sora-2-pro-storyboard. Array av '{ Scene, duration }'.
Merknader
- imageData har prioritet over imageUrl når begge er oppgitt.
- prompt er valgfritt for storyboard og sendes ikke til leverandøren; bruk shots for innhold.
- nFrames normaliseres til tillatte verdier per modell.
- removeWatermark er standard true for ikke-storyboard-modeller.
- shots må inkludere Scene (stor S) og duration > 0.
Eksempelforespørsler
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"
}'Eksempelsvar
{
"code": 0,
"message": "ok",
"data": {
"taskId": "281e5b0*********************f39b9"
}
}