哈基米API站

Appearance

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

使用豆包官方原生 API 格式提交 Seedance 2.0 视频生成任务（异步）。该接口是异步接口，提交成功后会先返回任务 id，再通过查询接口获取生成状态和视频地址。

重要提示 (关于 New API / One API 兼容性)

New API / One API 平台目前不支持此原生格式接口。 如果你的接口是通过 New API、One API 等中转分发平台进行管理的，请勿调用本接口（会导致请求路由失败），请改为使用 OpenAI 兼容格式的 v1 异步接口：提交视频生成任务（OpenAI 兼容格式 /v1/video/generations）。

与 /v1/video/generations 的区别

  • 请求格式： 使用豆包原生请求格式（content 在顶层，而不要放在 metadata 中）。
  • 参数一致： 参数名称和结构与豆包官方原生 API 完全一致。
  • 适用用户： 非常适合直接从豆包官方原生 API 迁移、不想调整原有参数结构的用户。

适合场景

如果你从豆包官方接口直接迁移，或需要使用图片、视频、音频等多模态引用，且不是通过 New API / One API 等中转分发系统调用，推荐使用这个原生格式。

接口信息 ​

项目值
方法POST
路径/api/v3/contents/generations/tasks
完整地址https://api.gemai.cc/api/v3/contents/generations/tasks
鉴权Authorization: Bearer sk-你的令牌
请求格式Content-Type: application/json

支持模型 ​

模型说明
doubao-seedance-2-0-260128标准版，画质和稳定性优先
doubao-seedance-2-0-fast-260128快速版，适合预览和草稿生成

请求参数 ​

字段类型必填说明
modelstring是模型 ID
contentarray是多模态内容数组
durationnumber否视频时长，常用 5、8、11；-1 表示智能选择
ratiostring否画面比例，例如 16:9、9:16
resolutionstring否分辨率，例如 480p、720p
watermarkboolean否是否带水印
seednumber否随机种子
generate_audioboolean否是否生成或使用音频

content 支持以下类型：

类型用途
text文生视频提示词
image_url图生视频、首帧、尾帧或参考图
video_url视频续拍或参考视频
audio_url背景音乐或参考音频

文生视频 ​

bash
curl --location 'https://api.gemai.cc/api/v3/contents/generations/tasks' \
  --header "Authorization: Bearer $GEMAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {
        "type": "text",
        "text": "宇航员在月球表面慢慢行走，地球悬挂在黑色天空中，画面宏大震撼"
      }
    ],
    "ratio": "16:9",
    "resolution": "720p",
    "duration": -1
  }'

图生视频 ​

图片地址必须是服务端可以访问的公网 URL。

json
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "让图片中的人物微笑并缓缓转身，眼神温柔"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/portrait.jpg"
      }
    }
  ],
  "duration": 5,
  "ratio": "16:9"
}

视频续拍 ​

传入已有视频后，模型会基于原视频继续生成后续镜头。

json
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "继续往前走，走向远处连绵起伏的山丘，镜头缓缓推进"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/input-clip.mp4"
      }
    }
  ],
  "duration": 5
}

多模态输入 ​

多模态任务可以同时引用图片、视频和音频，适合广告分镜、产品短片、参考音乐驱动等复杂需求。

json
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。首帧为图片1，尾帧定格为图片2，整体节奏轻快，画面干净明亮。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
      },
      "role": "reference_audio"
    }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "duration": 11,
  "watermark": true
}

快速版示例 ​

json
{
  "model": "doubao-seedance-2-0-fast-260128",
  "content": [
    {
      "type": "text",
      "text": "城市夜晚的延时摄影，车流如光河，霓虹闪烁"
    }
  ],
  "ratio": "16:9",
  "resolution": "480p",
  "duration": -1
}

返回示例 ​

json
{
  "id": "task_abc123def456",
  "model": "doubao-seedance-2-0-260128",
  "status": "pending",
  "created_at": 1712345678
}

保存返回的 id，然后前往 查询视频生成任务状态（豆包原生格式） 继续查询。

注意事项 ​

  • content 在顶层，不要放到 metadata 里。
  • 豆包原生格式使用 duration，且是数字类型。
  • 素材 URL 必须能公网访问，不要使用本地路径、内网地址或需要登录的链接。
  • 如需 OpenAI 兼容格式，请使用 提交视频生成任务（OpenAI 兼容格式）。