Criar tarefa de geração
Valida entrada, deduz créditos, cria uma tarefa e retorna taskId.
Método: POSTCaminho: /api/v1/video/sora-pro
Parâmetros do payload
- Obrigatório. Um de 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.
- Condicional. Obrigatório para todos os modelos exceto sora-2-pro-storyboard.
- Condicional. URL de dados Base64 como data:image/png;base64,... Obrigatório para image-to-video se não houver imageUrl.
- Condicional. URL pública de imagem usada quando imageData não é fornecido.
- Opcional. portrait ou landscape. Padrão: landscape.
- Opcional. 10, 15 ou 25 (apenas storyboard). Padrões variam por modelo.
- Opcional. standard ou high. Apenas para modelos Pro texto/imagem.
- Opcional. Remove marca d'água para modelos não-storyboard. Padrão: true.
- Condicional. Obrigatório para sora-2-pro-storyboard. Array de '{ Scene, duration }'.
Notas
- imageData tem precedência sobre imageUrl quando ambos são fornecidos.
- prompt é opcional para storyboard e não é enviado ao provedor; use shots para conteúdo.
- nFrames é normalizado para os valores permitidos por modelo.
- removeWatermark é true por padrão para modelos não-storyboard.
- shots deve incluir Scene (S maiúsculo) e duration > 0.
Exemplos de requisições
Texto para vídeo
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
}'Imagem para vídeo
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"
}'Storyboard
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"
}'Exemplo de resposta
{
"code": 0,
"message": "ok",
"data": {
"taskId": "281e5b0*********************f39b9"
}
}