1. 视频生成（豆包原生）
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. 视频生成（豆包原生）

提交视频生成任务（豆包原生）

POST
/doubao/api/v3/contents/generations/tasks
以火山方舟原生格式提交异步视频生成任务。
接口立即返回任务 ID，请用
GET /doubao/api/v3/contents/generations/tasks/{task_id} 轮询结果。
请求结构
content 在顶层，不放在 metadata 里。
prompt 可在顶层，也可作为 content 中的 text 条目。
时长字段是整数类型的 duration（如 5 或 -1）。
其余参数（ratio、resolution、watermark 等）在顶层。
支持的场景
场景content 条目
文生视频text
图生视频-首帧text + image_url，role 为 first_frame
图生视频-首尾帧text + 两个 image_url，role 分别为 first_frame、last_frame
全模态参考text + 任意组合的 image_url、video_url、audio_url
编辑视频引用 @视频1 的 text + video_url，并设 omni_reference_task_type: edit
延长视频引用 @视频1 的 text + video_url，并设 omni_reference_task_type: extend
素材引用
每个引用既可以是 HTTP(S) URL，也可以是 Base64 data URI，例如
data:image/png;base64,...，格式标识需小写。
渠道配置了图床时，网关会先把内联 Base64 上传到图床、改传得到的 URL，
因此 Base64 引用同样能走真人过白；未配置图床时原值直接转发。
单个渠道可在渠道设置里覆盖这一行为（跟随全局 / 始终转存 / 从不转存），
例如图床位于内网、上游拉不到时选择「从不转存」即可原样透传。
如何选路径
如需 OpenAI 兼容的请求结构，请改用 POST /v1/video/generations。

请求参数

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

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

请求示例代码

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

返回响应

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

示例
{
    "id": "cgt-20260414114820-abcde",
    "model": "doubao-seedance-2-0-260128",
    "status": "pending",
    "created_at": 1712345678
}
🟠400BadRequest
🟠401Unauthorized
🟠402InsufficientQuota
🟠429RateLimited
修改于 2026-11-02 11:41:04
下一页
查询视频生成任务（豆包原生）
Built with