Build on top of the Sora 2 API

Payload parameters

• Required. Use "sora-2" or "sora-2-pro" to target the model variant you need.
• Required. Natural language description of the scene you want Sora to create.
• Optional. Base64 data URL for image-to-video mode; uploaded to storage automatically.
• Optional. Supported values: "9:16" (default) or "16:9".
• Optional. HTTPS endpoint that receives the final result payload when the task succeeds.

Sample request

curl -X POST https://FreeSoraGenerator.com/api/v1/video/sora-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro",
    "prompt": "A cinematic shot of a futuristic city at sunset, captured in 4K.",
    "aspectRatio": "9:16"
  }'

Sample response

{
  "code": 0,
  "message": "Success",
  "data": {
    "taskId": "task-123",
    "status": "pending",
    "progress": 0,
    "estimate_seconds": 180
  }
}

Payload parameters

• Required. The identifier returned when you created the generation task.

Sample request

curl -X POST https://FreeSoraGenerator.com/api/video-generations/check-result \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "task-123"
  }'

Sample response

{
  "code": 0,
  "message": "Success",
  "data": {
    "status": "running",
    "progress": 45,
    "result_url": null,
    "result_urls": [],
    "failure_reason": null,
    "error_message": null,
    "credits_refunded": false
  }
}