火山引擎SeedanceSDK安装调用完整示例

需安装最新volcengine SDK并配置AK/SK环境变量，初始化客户端调用/v1/seedance/generate提交任务，再轮询/v1/seedance/tasks/{task_id}获取video_url，注意sleep(6)避免429限流。

你想在项目里直接调用火山引擎Seedance 2.0视频生成能力，不是用curl临时测试，而是要集成进生产环境，需要稳定、可维护、带错误重试和日志的SDK调用方式。

安装最新VolcEngine Python SDK

执行 pip install volcengine 命令安装最新版SDK。注意不要装错成 volc-sdk-python 或 volcenginesdk，【必须是 volcengine 最新包】，否则后续调用会报 ModuleNotFoundError: No module named 'volcengine'。

安装完成后，在Python交互环境中输入 import volcengine，不报错即为成功。

配置Access Key与Secret Key

登录火山引擎控制台 → 进入「访问密钥」管理页 → 创建新的AK/SK对 → 下载CSV文件并妥善保存。

将AK/SK写入环境变量（推荐），避免硬编码进代码：

Linux/macOS：export VOLC_ACCESSKEY=AKXXXXXXXX && export VOLC_SECRETKEY=SKXXXXXXXX

Windows PowerShell：$env:VOLC_ACCESSKEY="AKXXXXXXXX"; $env:VOLC_SECRETKEY="SKXXXXXXXX"

【切勿在代码中明文写入AK/SK，否则提交Git将导致密钥泄露】

初始化Seedance客户端并发起文生视频请求

创建 seedance_client.py 文件，粘贴以下代码：

from volcengine.service.volc_service import VolcService

from volcengine.exception.volc_exception import VolcException

import json

client = VolcService()

client.set_region('cn-north-1')

client.set_service_info({

"host": "ark.volcengineapi.com",

"ak": "", # 留空，自动从环境变量读取

"sk": "", # 留空，自动从环境变量读取

"version": "2024-07-01"

})

try:

resp = client.json_post("/v1/seedance/generate", {

"model": "seedance-2.0",

"prompt": "一只橘猫在窗台上伸懒腰，阳光洒在毛尖上，窗外有摇曳的树叶，4K电影感",

"duration": 5,

"resolution": "1080p",

"audio": True

})

task_id = resp["task_id"]

print(f"任务已提交，ID：{task_id}")

except VolcException as e:

print(f"API调用失败：{e.message}")

轮询获取生成结果（异步任务处理）

第一步提交只是创建任务，需主动轮询状态直到完成：

import time

def poll_task_result(client, task_id):

while True:

try:

resp = client.json_get(f"/v1/seedance/tasks/{task_id}")

if resp["state"] == "completed":

return resp["video_url"]

elif resp["state"] == "failed":

raise Exception(f"任务失败：{resp.get('error', '未知错误')}")

time.sleep(6)

except VolcException as e:

print(f"轮询异常：{e.message}")

time.sleep(6)

在主流程末尾追加：video_url = poll_task_result(client, task_id)；print(f"视频地址：{video_url}")。

这一步必须加 sleep(6)，因为火山方舟接口限流策略为每5秒最多1次查询，【sleep少于6秒可能触发429 Too Many Requests】。

完整运行验证

执行 python seedance_client.py，终端输出任务ID后等待约60–120秒，最终打印出以 https:// 开头的视频直链URL。

复制该URL到浏览器打开，即可看到Seedance 2.0生成的视频。