创建视频生成任务

启动异步 Seedance 视频生成任务并返回任务 ID。通过 GET /v1/tasks/{task_id} 查询进度。重试时使用同一个 request_id，避免重复创建任务。

POST/v1/videos/generations

Authorization

AuthorizationBearer <token>

在设置中创建 Open AI Image API 密钥，仅从可信服务端发送。

In: header

Request Body

modelstring

公开的视频模型 ID。

"seedance_2_5" | "seedance_2_0" | "seedance_2_0_fast" | "seedance_2_0_mini"

promptstring

描述你希望创建的视频。

1 <= length <= 10000

parameters?object

视频生成参数。未指定的参数使用模型默认值。

属性

duration?integer

视频时长（秒），可选值取决于模型。

1 <= value <= 30

resolution?string

输出分辨率，可选值取决于模型。

"480p" | "720p" | "1080p"

aspect_ratio?string

输出画幅比例；仅支持的模型接受 adaptive。

"16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9" | "adaptive"

generate_audio?boolean

模型支持时，设为 true 以生成同步音频。

reference_urls?array<string>

先在资产库上传属于此账号的素材，再使用返回的 /api/studio/media/ 路径。类型与数量取决于模型。下载私有结果时携带相同的 Authorization 头。

Array Item

string

此账号的私有素材路径。

max_creditsinteger

本次允许扣除的积分上限；实时报价超出上限时不会提交或扣费。

1–10000

request_id?string

UUID 格式的请求标识。重试时使用同一个值，避免重复创建任务与扣费。

format: uuid

Response Body

202

task_idstring

任务标识符。

statusstring

当前任务状态。

"pending" | "processing" | "success" | "failed" | "canceled"

credits_usednumber

任务所需积分。生成失败时积分自动退回。

outputsarray<object>

成功任务的输出素材。

Array Item

urlstring

输出素材的 URL。

thumbnail?string

可用时提供缩略图 URL。

error?string

任务失败时返回错误信息。

400

errorobject

Choose an available video model

属性

messagestring

错误信息。

codenumber

HTTP 状态码。

401

errorobject

A valid API key is required

属性

messagestring

错误信息。

codenumber

HTTP 状态码。

403

errorobject

Product API is disabled

属性

messagestring

错误信息。

codenumber

HTTP 状态码。

413

errorobject

Request is too large

属性

messagestring

错误信息。

codenumber

HTTP 状态码。

429

errorobject

Too many requests

属性

messagestring

错误信息。

codenumber

HTTP 状态码。

500

errorobject

Unable to complete the request

属性

messagestring

错误信息。

codenumber

HTTP 状态码。

503

errorobject

This model is not configured yet. Please try another model.

属性

messagestring

错误信息。

codenumber

HTTP 状态码。

curl -X POST "https://openaiimage.com/v1/videos/generations" \
  -H "Authorization: Bearer sk_sd_example" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance_2_0_fast",
  "prompt": "A paper boat crossing a rain-soaked neon street, cinematic camera movement",
  "parameters": {
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "request_id": "72c1ca71-5e68-4a76-9c3b-bbc036261e30",
  "max_credits": 65
}'

{
  "task_id": "d3a7b249c28a1e05f9210d16af47c86809a58cad92a36fc91138da677be03245",
  "status": "processing",
  "credits_used": 5,
  "outputs": []
}