1. 火山豆包官方格式(doubao-seedance-2-0-260128)
谐波AI Hub接口文档
模型接口
  • 模型接口
  • 平台介绍
  • 快速接入指南
  • 各模型接口列表
    • 获取模型(Models)
      • 获取可用模型接口
    • Anthropic(claude code)
      • 官方接口
        • 文本对话(优先)
      • OpenAI格式接口
        • 文本对话
    • OpenAI(codex,gpt-image-2)
      • 官方接口
        • 文本对话(官方推荐/新一代)
        • 文本对话(兼容接口)
        • 生成图像(gpt-image-2)
        • 编辑图像(gpt-image-2)
        • 创建视频
        • 获取视频任务状态
        • 获取视频内容
    • Google(gemini,Nano Banana)
      • 官方接口
        • 文本对话(优先)
        • 生成图像(Nano Banana)
      • OpenAI格式接口
        • 文本对话
        • 生成图像(Nano Banana)
    • xAI(grok)
      • OpenAI格式接口
        • 文本对话(兼容接口)
        • 生成图像(grok)
        • 创建视频(video)
        • 获取视频任务状态
        • 获取视频内容
    • 图像(Images)
      • OpenAI格式接口(doubao)
        • 生成图像
      • 通义千问格式
        • 生成图像
        • 编辑图像
    • 视频(Videos)
      • 通义千问格式(happyhorse-快乐马)
        • 创建视频(文生视频)
        • 创建视频(首帧图-图生视频)
        • 创建视频(参考图-图生视频)
        • 创建视频(编辑视频)
        • 获取视频生成任务状态
      • 火山豆包格式(seed-2.0)
        • 创建视频(文生视频)
        • 创建视频(首帧-图生视频)
        • 创建视频(首尾帧-图生视频)
        • 创建视频(参考图-图生视频)
        • 创建视频(多模态-参考生视频)
        • 获取视频生成任务状态
      • 火山豆包官方格式(doubao-seedance-2-0-260128)
        • 创建视频(文生视频)
          POST
        • 创建视频(首帧-图生视频)
          POST
        • 创建视频(首尾帧-图生视频)
          POST
        • 创建视频(参考图-图生视频)
          POST
        • 创建视频(多模态-参考生视频)
          POST
        • 获取视频生成任务状态
          GET
      • Openai格式(grok,Veo 3.1,seed-2.0)
        • 谷歌Veo 3.1
          • 创建视频(文生视频)
          • 创建视频(参考图-图生视频)
          • 获取视频生成任务状态
        • Openai Sora格式(seed-2.0特价)
          • 创建视频(文生视频)
          • 创建视频(多模态-参考生视频)
          • 获取视频生成任务状态
          • 获取视频内容
        • Openai Sora格式(grok video 1.5)
          • 创建视频(文生视频)
          • 创建视频(首帧图-图生视频)
          • 创建视频(参考图-图生视频)
          • 获取视频生成任务状态
          • 获取视频内容
  • 视频素材相关接口
    • 资源库 API 接入文档(火山官方格式)
    • 资源库 API 接入文档
    • 上传素材
      POST
    • 查询素材列表
      GET
    • 查询单个素材
      GET
    • 修改素材描述
      PUT
    • 删除素材
      DELETE
  • 工具配置教程
    • CC Switch 配置
    • Claude Code配置
    • Codex配置
    • Gemini CLI配置
    • OpenCode 配置
    • Cursor 配置
    • node 安装教程
  • 法律与政策
    • 服务协议
    • 隐私政策
  1. 火山豆包官方格式(doubao-seedance-2-0-260128)

创建视频(多模态-参考生视频)

POST
https://ai-api.kkidc.com/sd/api/v3/contents/generations/tasks
使用该路径,支持官方原生模型ID,参数和响应,选择seedance-common分组
注意:涉及人脸,虚拟人图片需走素材库接口过审,否则视频会生成失败
模型ID:
doubao-seedance-2-0-260128
doubao-seedance-2-0-fast-260128
doubao-seedance-2-0-mini-260615
doubao-seedance-2-5-260628

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json必填

示例
{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐。第一人称视角果茶宣传广告,seedance牌「苹苹安安」苹果果茶限定款;首帧为图片1,你的手摘下一颗带晨露的阿克苏红苹果,轻脆的苹果碰撞声;2-4 秒:快速切镜,你的手将苹果块投入雪克杯,加入冰块与茶底,用力摇晃,冰块碰撞声与摇晃声卡点轻快鼓点,背景音:「鲜切现摇」;4-6 秒:第一人称成品特写,分层果茶倒入透明杯,你的手轻挤奶盖在顶部铺展,在杯身贴上粉红包标,镜头拉近看奶盖与果茶的分层纹理;6-8 秒:第一人称手持举杯,你将图片2中的果茶举到镜头前(模拟递到观众面前的视角),杯身标签清晰可见,背景音「来一口鲜爽」,尾帧定格为图片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": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.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"
        }
    ],
    "duration": 11,
    "resolution": "480p",
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://ai-api.kkidc.com/sd/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": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐。第一人称视角果茶宣传广告,seedance牌「苹苹安安」苹果果茶限定款;首帧为图片1,你的手摘下一颗带晨露的阿克苏红苹果,轻脆的苹果碰撞声;2-4 秒:快速切镜,你的手将苹果块投入雪克杯,加入冰块与茶底,用力摇晃,冰块碰撞声与摇晃声卡点轻快鼓点,背景音:「鲜切现摇」;4-6 秒:第一人称成品特写,分层果茶倒入透明杯,你的手轻挤奶盖在顶部铺展,在杯身贴上粉红包标,镜头拉近看奶盖与果茶的分层纹理;6-8 秒:第一人称手持举杯,你将图片2中的果茶举到镜头前(模拟递到观众面前的视角),杯身标签清晰可见,背景音「来一口鲜爽」,尾帧定格为图片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": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.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"
        }
    ],
    "duration": 11,
    "resolution": "480p",
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "id": "task_1RkY******cXAdgRRzTyJIF"
}
🟠429限流
🟠400请求有误
修改于 2026-08-28 03:13:38
上一页
创建视频(参考图-图生视频)
下一页
获取视频生成任务状态
Built with