You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
视频生成 API
创建视频生成任务
复制全文
下载 pdf
创建视频生成任务
POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks​
本文介绍创建视频生成任务 API 的输入输出参数,供您使用接口时查阅字段含义。模型会依据传入的图片及文本信息生成视频,待生成完成后,您可以按条件查询任务并获取生成的视频。​
使用必读​
Seedance 2.5 已全面公开,您可在火山方舟平台调用 API 及在线体验。调用模型前,请务必仔细查阅 使用必读,以确保正确设置任务类型和配置参数。​
限时优惠​
Seedance 2.0 mini 与 Seedance 2.0 fast 现已开启限时优惠活动,优惠仅适用于企业用户,且达到规定的 token 用量上限后将恢复按刊例价结算,规则详见 Seedance 模型限时折扣活动规则。​
  • Seedance 2.0 mini:北京时间(UTC+8)2026 年 8 月 7 日 14:00 至 10 月 7 日 14:00 期间,480p、720p 分辨率均按刊例价 4 折计费,以 720p 为例,最低降至约 0.2 元/秒。​
  • Seedance 2.0 fast:北京时间(UTC+8)2026 年 8 月 7 日 14:00 至 10 月 7 日 14:00 期间,480p、720p 分辨率均按刊例价 75 折计费,以 720p 为例,最低降至约 0.6 元/秒。​
模型开通条件​
​
模型能力​
​
参数传入方式说明​
​
​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • API Key 鉴权,请在 API Key 管理 页面,获取长效 API Key。​
​​
请求参数​
Body 参数​
model string 必选 | 模型 ID​
​
content object[] 必选 | 输入内容列表​
​
omni_reference_task_typenew string 默认值 auto | 任务类型引导​
​
resolution string | 视频分辨率​
​
ratio string | 视频宽高比​
​
duration integer | 视频时长​
​
frames integer | 视频帧数​
​
generate_audio boolean 默认值 true | 生成有声视频​
​
watermark boolean 默认值 false | 视频水印​
​
output_formatnew string 默认值 mp4 | 输出格式​
​
seed integer 默认值 -1 | 随机种子​
​
camera_fixed boolean 默认值 false | 固定摄像头​
​
return_last_frame boolean 默认值 false | 返回尾帧​
​
draft boolean 默认值 false | 样片模式​
​
service_tier string 默认值 default | 服务等级​
​
callback_url string | 回调地址​
​
execution_expires_after integer 默认值 172800 | 任务超时阈值​
​
priority integer 默认值 0 | 执行优先级​
​
safety_identifier string | 用户标识​
​
tools object[] | 工具配置​
​
​
响应参数​
id string | 任务 ID​
​
​

Request

import os
import time
# Install SDK: python -m pip install --upgrade arkruntime
from arkruntime import Ark

client = Ark(
    # The base URL for model invocation
    base_url='https://ark.cn-beijing.volces.com/api/v3',
    # Get API Key:https://ark.volcengine.com/region:cn-beijing/apikey
    api_key=os.environ.get("ARK_API_KEY"),
)

if __name__ == "__main__":
    print("----- create request -----")
    create_result = client.content_generation.tasks.create(
        model="doubao-seedance-2-5-260628", # Replace with Model ID
        content=[
            {
                "type": "text",
                "text": "明亮多彩的广告片风格,果味饼干为主角,包含草莓、苹果、葡萄、橙子四种口味,草莓味参考@图像1,饼干与对应水果以强秩序感的几何阵列排布,整体画面干净、高级、节奏强。开场水果快速建立视觉聚焦,参考@视频1的构图,音乐重拍切入。随后不同口味饼干整齐排列,切特写,参考@视频2的动态和运镜。高潮段一块饼干被折断,瞬间进入慢动作,果味夹心爆开,碎屑飞溅,果汁感与颗粒冲击被放大展示,参考@视频3的冲击感。横向阵列,形成节奏抛物感,参考@视频4的运动,突出秩序美感与产品丰富度。随后迅速回到快节奏剪辑。结尾英文文字 One bite of crispness, a heart full of delight 快速分词切换入画,配合强节奏文字运动与产品定格,参考@视频5,最终品牌感收束,饼干和水果向四周发散,参考@视频6画面充满年轻、活力、好吃、想分享的广告氛围。",
            },
            {
                "type": "image_url",
                "image_url": {
                    "url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_reference1.png"
                },
                "role": "reference_image",
            },
            {
                "type": "video_url",
                "video_url": {
                    "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference2.mp4"
                },
                "role": "reference_video",
            },
            {
                "type": "video_url",
                "video_url": {
                    "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference3.mp4"
                },
                "role": "reference_video",
            },
            {
                "type": "video_url",
                "video_url": {
                    "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference4.mp4"
                },
                "role": "reference_video",
            },
            {
                "type": "video_url",
                "video_url": {
                    "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference5.mp4"
                },
                "role": "reference_video",
            },
            {
                "type": "video_url",
                "video_url": {
                    "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference6.mp4"
                },
                "role": "reference_video",
            },
            {
                "type": "video_url",
                "video_url": {
                    "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference7.mp4"
                },
                "role": "reference_video",
            },
        ],
        generate_audio=True,
        ratio="16:9",
        duration=15,
        extra_body={
            "omni_reference_task_type": "reference",
            "output_format": "mov",
        },
    )
    print(create_result)


    # Polling query section
    print("----- polling task status -----")
    task_id = create_result.id
    deadline = time.monotonic() + 30 * 60
    while time.monotonic() < deadline:
        get_result = client.content_generation.tasks.get(task_id=task_id)
        status = get_result.status
        if status == "succeeded":
            print("----- task succeeded -----")
            print(get_result)
            break
        elif status == "failed":
            raise RuntimeError(f"Video generation task failed: {get_result.error}")
        else:
            print(f"Current status: {status}, Retrying after 10 seconds...")
            time.sleep(10)
    else:
        raise TimeoutError("Video generation task did not finish within 30 minutes")

Response

----- create request -----
ContentGenerationTaskID(id='cgt-20260414114820-*****')
----- polling task status -----
Current status: running, Retrying after 10 seconds...
Current status: running, Retrying after 10 seconds...
Current status: running, Retrying after 10 seconds...
...
----- task succeeded -----
ContentGenerationTask(id='cgt-20260414114820-*****', model='doubao-seedance-2-0-260128', status='succeeded', error=None, content=Content(video_url='https://xxx', last_frame_url=None, file_url=None), usage=Usage(completion_tokens=411300, total_tokens=411300), frames=None, framespersecond=24, created_at=1776138520, updated_at=1776139219, seed=33608, service_tier='default', execution_expires_after=172800, generate_audio=True, duration=11, ratio='16:9', output_format='mov', resolution='720p', draft=False, draft_task_id=None)
最近更新时间:2026.09.22 18:00:03
这个页面对您有帮助吗?
有用
有用
无用
无用