Sora 2 系列

POST

tasks

Sora 2 系列

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 与 sora-2-pro 已于 2026-09-24 下架（OpenAI 关停 Sora 2 全部模型与 Videos API），本页仅作存档，调用将返回错误。视频生成请改用 Veo 3.1 系列或视频模型总览中的其他模型

OpenAI Sora 2 生成物理表现稳定、自带同步音轨（对白、音效与环境声）的写实视频，多镜头一致性强。本页覆盖 sora-2 与 sora-2-pro：两个模型的动作、参数集合和取值范围完全相同，只有可选分辨率不同，换档只改 model。生成请求统一走 POST /v1/tasks 异步提交。

快速开始

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": "瀑布飞泻而下，水雾中升起一道彩虹，镜头缓慢横移",
    "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": "镜头缓缓推近，人物迎风转身",
    "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": "黄昏的海滩，女孩迎着夕阳奔跑，海浪声与脚步声同步",
    "duration": 12,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

提交成功后返回 task_id。用 GET /v1/tasks/{task_id} 查询结果，也可以用 Prefer: wait 在一次调用里等待，或配置 Webhook。

请求参数

string

必填

两选一：sora-2 或 sora-2-pro。

string

默认值:"generate"

generate 是本系列唯一的动作。文生视频与图生视频不靠动作区分，靠传不传 image_urls。

string

必填

视频描述。建议写清场景、主体、动作、镜头与氛围。

integer

视频时长（秒），取值 4、8、12、16、20。时长直接决定费用。

string

输出分辨率。sora-2 仅支持 720p；sora-2-pro 支持 720p、1024p、1080p。

string

默认值:"16:9"

画面比例，16:9 或 9:16。传 image_urls 时该参数被忽略，比例跟随输入图。

integer

随机种子。相同提示词与相同种子可复现相近结果。

string[]

参考图 URL 数组，用于图生视频，最多 1 张。不传即为文生视频。

通用的 callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。 Sora 2 系列没有专有参数，以上之外的参数会返回 400，不计费。

限制

图生视频时 aspect_ratio 被忽略，比例跟随输入图
本模型一次任务只产出一个结果，不支持用 n 批量生成

项目	上限
参考图 `image_urls`	最多 1 张，单张 ≤ 10MB，JPEG / PNG / WebP
时长 `duration`	`4` / `8` / `12` / `16` / `20` 秒
分辨率 `resolution`	`sora-2`：`720p`；`sora-2-pro`：`720p` / `1024p` / `1080p`
画幅 `aspect_ratio`	`16:9` / `9:16`

计费

按输出分辨率档 × 输出秒数计费，秒数取请求里的 duration。sora-2 只有 720p 一档；sora-2-pro 的 720p、1024p、1080p 三档单价各不相同，分辨率越高越贵。文生视频与图生视频走同一档，参考图不单独计费；aspect_ratio、seed 和提示词长度都不影响价格。分辨率与时长是仅有的两个计费维度，提交前即可确定单次费用。

单价会随上游调整，本节只讲计费维度与口径，不列具体金额。看实时单价：GET /v1/models 的 price_config，或控制台「模型市场」。看单次实际费用：任务响应里的 cost（整数 quota，500,000 quota = 1 USD）。

只有成功出片才计费。任务失败、取消，或上游返回成功但没有可交付视频时，全额退款。最终费用以任务响应里的 cost 为准，cost 是整数 quota 不是美元（500,000 quota = 1 USD）。

响应

任务完成

{
  "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"
  }
}

result.videos 返回生成的视频，url 是数组，expires_at 是链接过期时间（Unix 秒），过期前请自行转存。完整字段说明见查询任务状态。

可用模型

模型 ID	分辨率	时长（秒）	动作	说明
`sora-2`	`720p`	4 / 8 / 12 / 16 / 20	`generate`	标准档，文生与图生通用
`sora-2-pro`	`720p` / `1024p` / `1080p`	4 / 8 / 12 / 16 / 20	`generate`	高阶档，制作质量与分辨率上限更高

相关文档

Sora 2 系列

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();

文本生成

图像生成

视频生成

音频处理

工具与嵌入

任务管理

账户与用量

快速开始

请求参数

限制

计费

响应

可用模型

相关文档

​快速开始

​请求参数

​限制

​计费

​响应

​可用模型

​相关文档

快速开始

请求参数

限制

计费

响应

可用模型

相关文档