1. 视频生成（OpenAI 兼容）
Ark-中文文档
  • 视频生成（豆包原生）
    • 提交视频生成任务（豆包原生）
      POST
    • 查询视频生成任务（豆包原生）
      GET
  • 视频生成（OpenAI 兼容）
    • 提交视频生成任务（OpenAI 兼容）
      POST
    • 查询视频生成任务
      GET
    • 提交视频生成任务（OpenAI Video 别名）
      POST
    • 查询视频生成任务（OpenAI Video 别名）
      GET
  • 视频内容
    • 下载生成的视频文件
      GET
  • 图像生成（豆包原生）
    • 图像生成（豆包原生）
      POST
  • 图像生成（OpenAI 兼容）
    • 图像生成（OpenAI 兼容）
      POST
    • 图像编辑（OpenAI 兼容）
      POST
  • 素材库（豆包原生）
    • 素材库管理（豆包原生）
      POST
  • 数据模型
    • VideoGenerationRequest
    • VideoFormDataRequest
    • VideoMetadata
    • DoubaoNativeVideoRequest
    • DoubaoNativeContentItem
    • VideoTaskResponse
    • DoubaoNativeVideoResponse
    • VideoTaskError
    • DoubaoImageRequest
    • ImageEditFormDataRequest
    • DoubaoImageResponse
    • ErrorResponse
    • DoubaoAssetRequest
    • DoubaoAssetResponse
  1. 视频生成（OpenAI 兼容）

提交视频生成任务（OpenAI 兼容）

POST
/v1/video/generations
以 OpenAI 兼容结构提交异步视频生成任务。
接口立即返回任务 ID，请用 GET /v1/video/generations/{task_id}
或 GET /v1/videos/{task_id} 轮询结果。
请求结构
顶层放 model、prompt、seconds，以及可选的 image URL。
扩展参数（ratio、resolution、generate_audio、watermark、
content 等）放进 metadata 对象。
seconds 是字符串；"-1" 表示由模型选择时长。
支持的场景
场景所需字段
文生视频model、prompt
图生视频-首帧model、prompt、image
图生视频-首尾帧model、prompt、metadata.content 中含 role: first_frame 与 role: last_frame 两个条目
全模态参考model、prompt、metadata.content 中含多个素材条目
编辑视频model、prompt、metadata.content 中含 video_url，并设 omni_reference_task_type: edit
延长视频model、prompt、metadata.content 中含 video_url，并设 omni_reference_task_type: extend
素材引用
image 与 metadata.content 的每个条目都支持 HTTP(S) URL 或 Base64
data URI（如 data:image/png;base64,...）。上传文件会被拒绝，
请把素材作为取值传入。
文件上传
参考素材必须可通过 URL 访问。本接口接受 multipart/form-data，
以便把标量字段作为表单字段提交，但上传的文件会被拒绝；
素材请以 URL 形式放进 metadata.content。
计费
费用随时长变化。seconds 为 "-1" 时由模型决定时长，
实际时长在任务结果的 duration 字段中返回。

请求参数

Authorization
JWT Bearer
在 Header 添加参数
Authorization
示例：
Authorization: ********************
or
Body 参数
application/json
必填

示例
{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "宇航员在月球表面缓慢行走，地球悬挂在黑色星空中",
    "seconds": "5",
    "metadata": {
        "ratio": "16:9",
        "resolution": "720p"
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location '/v1/video/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "宇航员在月球表面缓慢行走，地球悬挂在黑色星空中",
    "seconds": "5",
    "metadata": {
        "ratio": "16:9",
        "resolution": "720p"
    }
}'

返回响应

🟢200
application/json
任务已受理，处于排队状态，status 为 queued。
Bodyapplication/json

示例
{
    "id": "task_abc123def456",
    "object": "video",
    "model": "doubao-seedance-2-0-260128",
    "status": "queued",
    "progress": 0,
    "created_at": 1712345678
}
🟠400BadRequest
🟠401Unauthorized
🟠402InsufficientQuota
🔴500ServerError
修改于 2026-10-28 04:38:23
上一页
查询视频生成任务（豆包原生）
下一页
查询视频生成任务
Built with