Sora 2 Series

POST

tasks

Sora 2 Series

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "seed": 123,
  "image_urls": [
    "<string>"
  ]
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "seed": 123,
    "image_urls": ["<string>"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    seed: 123,
    image_urls: ['<string>']
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"seed\": 123,\n  \"image_urls\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"seed\": 123,\n  \"image_urls\": [\n    \"<string>\"\n  ]\n}")
  .asString();

sora-2 and sora-2-pro were delisted on 2026-09-24 (OpenAI shut down every Sora 2 model and the Videos API); this page is kept for reference only and calls will return an error. For video generation use the Veo 3.1 Series or another model in the video models overview

OpenAI Sora 2 produces physically consistent, photorealistic video with a synchronized audio track (dialogue, sound effects and ambience) and strong multi-shot consistency. This page covers sora-2 and sora-2-pro: both models expose the same action, the same parameters and the same value ranges, and differ only in the resolutions they accept — switching tiers means changing model. Every request is submitted asynchronously through POST /v1/tasks.

Quick start

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: sora-demo-001" \
  -d '{
    "model": "sora-2",
    "action": "generate",
    "prompt": "A waterfall cascading down, a rainbow rising through the mist, slow lateral camera move",
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "action": "generate",
    "prompt": "The camera pushes in slowly as she turns into the wind",
    "image_urls": ["https://cdn.example.com/portrait.jpg"],
    "duration": 8,
    "resolution": "720p"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro",
    "action": "generate",
    "prompt": "A girl running toward the sunset on a beach, footsteps and surf in sync",
    "duration": 12,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

A successful submission returns a task_id. Retrieve the result with GET /v1/tasks/{task_id}, wait inline with Prefer: wait, or configure a webhook.

Request parameters

string

必填

Either sora-2 or sora-2-pro.

string

默认值:"generate"

generate is the only action in this series. Text-to-video and image-to-video are selected by whether you send image_urls, not by the action.

string

必填

The video description. Describe the scene, subject, motion, camera and mood.

integer

Video length in seconds: 4, 8, 12, 16 or 20. Length drives the price directly.

string

Output resolution. sora-2 supports 720p only; sora-2-pro supports 720p, 1024p and 1080p.

string

默认值:"16:9"

Frame ratio, 16:9 or 9:16. Ignored when image_urls is present — the ratio follows the input image.

integer

Random seed. The same prompt and seed reproduce similar results.

string[]

Reference image URLs for image-to-video, up to one image. Omit it for text-to-video.

See Submit Task for callback_url, callback_events, Prefer: wait, Idempotency-Key and the maximum-cost header. The Sora 2 series has no model-specific parameters. Any other parameter returns 400 and is not billed.

Limits

aspect_ratio is ignored in image-to-video
This model produces one result per task; n is not supported

Item	Limit
Reference image `image_urls`	Up to 1 image, 10MB each, JPEG / PNG / WebP
Duration `duration`	`4` / `8` / `12` / `16` / `20` seconds
Resolution `resolution`	`sora-2`: `720p`; `sora-2-pro`: `720p` / `1024p` / `1080p`
Aspect ratio `aspect_ratio`	`16:9` / `9:16`

Pricing

Billing is resolution tier × output seconds, where the seconds come from the duration you send. sora-2 has a single 720p tier; sora-2-pro prices 720p, 1024p and 1080p separately, and higher resolutions cost more. Text-to-video and image-to-video use the same tier, reference images carry no extra charge, and aspect_ratio, seed and prompt length do not affect the price. Resolution and duration are the only two billing dimensions, so the cost of a call is known before you submit it.

Rates move with the upstream, so this section describes billing dimensions only and lists no amounts.Current rates: price_config on GET /v1/models, or the Model Market in the console. Actual cost of one call: the cost field on the task response (an integer quota; 500,000 quota = 1 USD).

You are billed only for a delivered video. Failed and cancelled tasks, and upstream successes that carry no deliverable video, are refunded in full. The final charge is the cost field on the task response — an integer quota, not dollars (500,000 quota = 1 USD).

Response

Completed task

{
  "task_id": "task-wave1775285160b950328499",
  "model": "sora-2",
  "action": "generate",
  "status": "completed",
  "progress": "100%",
  "created_at": 1775285160,
  "completed_at": 1775285280,
  "result": {
    "videos": [
      {
        "expires_at": 1775371560,
        "url": ["https://cdn.example.com/result.mp4"]
      }
    ]
  },
  "billing_status": "settled",
  "cost": 67500,
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499/cancel"
  }
}

Generated videos are returned in result.videos; url is an array and expires_at is the link expiry in Unix seconds, so copy the file to your own storage before then. See Query Task Status for the full field reference.

Available models

Model ID	Resolution	Duration (s)	Action	Notes
`sora-2`	`720p`	4 / 8 / 12 / 16 / 20	`generate`	Standard tier for both text- and image-driven shots
`sora-2-pro`	`720p` / `1024p` / `1080p`	4 / 8 / 12 / 16 / 20	`generate`	Higher tier with more production quality and a higher resolution ceiling

Sora 2 Series

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "seed": 123,
  "image_urls": [
    "<string>"
  ]
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "seed": 123,
    "image_urls": ["<string>"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    seed: 123,
    image_urls: ['<string>']
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"seed\": 123,\n  \"image_urls\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"seed\": 123,\n  \"image_urls\": [\n    \"<string>\"\n  ]\n}")
  .asString();

开始

核心概念

Quick start

Request parameters

Limits

Pricing

Response

Available models

​Quick start

​Request parameters

​Limits

​Pricing

​Response

​Available models

​Related

Quick start

Request parameters

Limits

Pricing

Response

Available models

Related