Seedance 视频生成 API

doubao-seedance-2.0 · 图文音多模态参考生成 · 完整流程

/
STEP 1 · 提交生成任务 · SUBMIT GENERATION
提交生成任务 (POST) 
curl -X POST https://startoken.link/v1/video/generations \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-xxx",
    "prompt": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8 秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。",
    "content": [
        {
            "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"
        }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 11,
    "watermark": false
}'
STEP 2 · 查询生成状态 · QUERY STATUS
查询生成状态 (GET) 
curl -X GET "https://startoken.link/v1/video/generations/{task_id}" \
  -H "Authorization: Bearer sk-xxx"
Seedance 官方路径 · 完全兼容火山引擎接口
提交生成任务 · 官方路径 (POST) 
curl -X POST "https://startoken.link/api/v3/contents/generations/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxx" \
  -d '{
    "model": "doubao-seedance-2.0",
    "content": [
        {
            "type": "text",
            "text": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8 秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。"
        },
        {
            "type": "image_url",
            "role": "reference_image",
            "image_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg" }
        },
        {
            "type": "image_url",
            "role": "reference_image",
            "image_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg" }
        },
        {
            "type": "video_url",
            "role": "reference_video",
            "video_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4" }
        },
        {
            "type": "audio_url",
            "role": "reference_audio",
            "audio_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3" }
        }
    ],
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 11,
    "generate_audio": true,
    "watermark": false,
    "return_last_frame": true,
    "safety_identifier": "user-123456"
}'
查询生成状态 · 官方路径 (GET) 
curl -X GET "https://startoken.link/api/v3/contents/generations/tasks/{task_id}" \
  -H "Authorization: Bearer sk-xxx"

content[]

提示词放 content[].text；素材角色：first_frame / last_frame / reference_image / reference_video / reference_audio

resolution

480p / 720p / 1080p，默认 720p

ratio

16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive，默认 adaptive

duration

视频时长（秒），合法范围 [4, 15]，或传 -1 由模型智能选择

return_last_frame

true 时查询响应返回 content.last_frame_url（尾帧 PNG，可作下一任务首帧实现连续生成）

seed

随机种子，不传由模型随机；查询响应回显实际使用值

Seedance 官方路径 · 使用提示

完整工作流程

1

提交生成任务

调用 POST /v1/video/generations 接口，传入模型、提示词、参考内容（图片/视频/音频）和输出参数。接口会立即返回一个 task_id。

2

轮询查询状态

使用上一步返回的 task_id，调用 GET /v1/video/generations/{task_id} 接口。视频生成需要时间，建议每 5-10 秒查询一次，直到状态变为 completed 或 failed。

3

获取结果视频

当任务状态为 completed 时，响应体中包含生成的视频 URL。下载后即可使用。

model

doubao-seedance-2.0 — 字节跳动视频生成模型
可选: 2.0 (最新) · 1.5 (稳定) · 1.0 (兼容) · t2i-2.0 (文生图)

ratio

16:9 横屏比例，适合宣传广告投放

duration

11 秒视频时长，匹配 8 秒分镜 + 3 秒余量

generate_audio

true — 自动生成匹配画面情绪的音效与配音

watermark

false — 关闭水印，输出纯净视频

content (4种媒体)

图片×2 (参考图) · 视频×1 (参考视频) · 音频×1 (参考音频)

使用提示

素材资产库 · ASSET LIBRARY API
通过模型定位渠道，自动完成移动云 OpenAPI 签名，管理素材组与素材 
base https://startoken.link/v1/maas \
  auth  "Authorization: Bearer sk-xxx" \
  route 渠道定位: ?model=doubao-seedance-2.0
素材组 · ASSET GROUP
创建素材组 (POST) 
curl -X POST "https://startoken.link/v1/maas/asset-groups?model=doubao-seedance-2.0" \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "groupType": "AIGC",
    "groupName": "我的素材组",
    "description": "测试素材组"
}'

POST /v1/maas/asset-groups

创建素材组
groupType(AIGC) · groupName · description

POST /v1/maas/asset-groups/query

查询素材组列表
pageNo · pageSize · groupType · groupName

GET /v1/maas/asset-groups/{groupId}

查询素材组详情

PUT /v1/maas/asset-groups/{groupId}

更新素材组
groupName · description

DELETE /v1/maas/asset-groups/{groupId}

删除素材组
素材 · ASSET
创建素材（URL 上传，异步）(POST) 
curl -X POST "https://startoken.link/v1/maas/assets?model=doubao-seedance-2.0" \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "groupId": "GROUP_ID",
    "assetName": "人像素材1",
    "assetUrl": "https://example.com/portrait.jpg",
    "assetType": "Image"
}'

POST /v1/maas/assets

创建素材（异步）
groupId · assetName · assetUrl · assetType(Image/Video/Audio)

POST /v1/maas/assets/query

查询素材列表
pageNo · pageSize · groupIds · assetName · statuses

GET /v1/maas/assets/{assetId}

查询素材详情 / 轮询状态

PUT /v1/maas/assets/{assetId}

更新素材

DELETE /v1/maas/assets/{assetId}

删除素材
真人认证 · REAL-PERSON AUTH

POST /v1/maas/real-person-auth/sessions

创建 H5 认证会话
返回 bytedToken · h5Link · expiresIn

POST /v1/maas/real-person-auth/asset-groups/by-byted-token

通过 bytedToken 查询关联素材组
body: { bytedToken }

真人认证流程

① 创建 H5 认证会话，获取 bytedToken / h5Link / expiresIn
② 在浏览器打开 h5Link 完成实名认证
③ 携带 bytedToken 查询认证关联的真人素材组
④ 在该素材组下上传真人素材（assetType 见上：Image/Video/Audio）

素材资产库 · 使用提示

Powered by Startoken API · Seedance 2.0 Video Generation