Video Gen API 开发者文档
使用指南火山兼容APIOpenAI 兼容API在线调试帮助支持

创建视频生成任务 API

POST /api/v3/contents/generations/tasks

POST
/api/v3/contents/generations/tasks

Authorization

BearerAuth

AuthorizationBearer <token>

输入 API Token。请求将使用 Authorization: Bearer

In: header

Request Body

application/json

model*string

Model ID 或 Endpoint ID

content*

视频生成输入;可组合文本、图片、视频、音频或样片任务 ID

Items1 <= items
callback_url?string

任务状态变更时的 POST 回调地址

Formaturi
return_last_frame?boolean

是否返回尾帧图像

Defaultfalse
service_tier?string
Default"default"
Value in"default" | "flex"
execution_expires_after?integer

任务超时阈值,单位为秒

Default172800
Range3600 <= value <= 259200
generate_audio?boolean

是否生成同步音频

Defaulttrue
draft?boolean

是否开启样片模式(仅支持的模型)

Defaultfalse
tools?

模型工具配置(仅支持的模型)

safety_identifier?string

终端用户的固定唯一安全标识

Lengthlength <= 64
priority?integer
Default0
Range0 <= value <= 9
resolution?string
Value in"480p" | "720p" | "1080p" | "4k"
ratio?string
Value in"16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "adaptive"
duration?integer

视频时长(秒);-1 表示由支持的模型自动选择

Default5
Range-1 <= value <= 15
frames?integer

视频帧数;与 duration 二选一,优先级更高

seed?integer
camera_fixed?boolean
watermark?boolean

Response Body

application/json

application/json

application/json

curl -X POST "https://jieyun.cc/api/v3/contents/generations/tasks" \  -H "Content-Type: application/json" \  -d '{    "model": "doubao-seedance-2-0-260128",    "content": [      {        "type": "text",        "text": "清晨的海边,一架纸飞机迎着风飞行"      }    ],    "duration": 5,    "resolution": "720p",    "ratio": "16:9",    "generate_audio": true  }'
{
  "id": "cgt-2026****-****",
  "model": "doubao-seedance-2-0-260128",
  "status": "queued",
  "created_at": 1784505600
}
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

最后更新于