火山引擎SeedanceSDK安装调用完整示例-人工智能-PHP中文网

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

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

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

你想在项目里直接调用火山引擎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将导致密钥泄露】

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

下载

初始化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": "2023-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】。