Integrate Sora 2 Pro via API

Payload parameters

• Required. Use one of the supported model strings above.
• Required except for storyboard. Describe the scene you want to generate.
• Required for image-to-video. Base64 data URL with prefix "data:image/*;base64,".
• Optional. Public image URL if you prefer not to send base64.
• Optional. "landscape" or "portrait" (default landscape).
• Optional. "10"/"15"/"25" (25 is storyboard only).
• Optional (Pro text/image). "standard" or "high".
• Optional (text/image). Remove watermark flag, default true.
• Required for storyboard. Array of shots with scene and duration.
• Optional. Whether the result is public, default true.

Sample request

curl -X POST https://sora2-api.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 tracking shot through a neon-lit street market at dusk.",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true,
    "isPublic": true
  }'

Sample response

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task_1234567890",
    "taskId": "task_1234567890"
  }
}

Payload parameters

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

Sample request

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

Sample response

{
  "code": 0,
  "message": "Success",
  "data": {
    "task_id": "task_1234567890",
    "status": "running",
    "progress": 0,
    "result_url": ""
  }
}

Sample request

curl -X POST https://sora2-api.com/api/get-user-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Sample response

{
  "code": 0,
  "message": "ok",
  "data": {
    "left_credits": 120,
    "is_vip": true
  }
}