terminal
复制后合并到自己的配置；请在本地安全设置真实凭据。
python3 seedance-task.py create --api seedance-2 --payload request.json --state video-task.json
python3 seedance-task.py query --state video-task.json正在打开页面…
正在加载内容，请稍候。
图生视频教程从一张可用图片开始：核对模型的图片输入、比例和时长要求，提交后保存任务 ID，再查询状态并下载结果。客户端超时先查已有任务，按对应接口检查失败原因，避免重复提交。
资料核对：。附 Python 任务脚本，已验证本地模拟轮询、错误与恢复流程；没有使用付费密钥生成样片，不提供真实生成时长或成功率。
配置前准备
- 准备拥有使用权的图片，避免上传身份证件或未经授权的人像
- 确认模型支持图生视频，并核对图片格式、比例、大小及视频时长限制
- 设置小额预算，先做单次任务，不直接批量重试
完整工作流
- 1
开发者接入 Seedance：下载完整 Python 脚本，按创建接口文档保存 request.json，并在环境变量设置 tokenba_API_KEY。确认价格后运行 create（会创建付费任务）；超时只运行 query 继续查询。Seedance 2.0 使用 /api/v3，旧版使用 /volc/v1，两者不能混用。
- 2
先定义验收目标，例如主体保持一致、镜头缓慢推进、背景不切换。一次只改变一个变量，便于比较。
- 3
在创作工作台选择图生视频模型并上传图片。提示词重点写主体动作、镜头运动与限制，不重复堆砌静态画面细节。
请求或配置示例
复制后合并到自己的配置；请在本地安全设置真实凭据。
主体：人物保持原有服装和面部特征 动作：轻微转头，动作自然 镜头：固定机位，缓慢推近 限制：不切换场景，不增加人物 - 4
按模型允许的范围选择比例和时长。提交后保存任务 ID、模型 ID、参数及时间；接口超时时先查询已有任务，避免重复提交产生额外费用。
- 5
依据对应接口文档查询任务，使用合理间隔并对限流退避。处理等待、执行中、完成和失败状态，设置总等待上限，不无限轮询。
- 6
完成后检查文件是否可下载、时长和画面是否满足目标，再保存结果。结果链接的有效期以服务返回为准，不把临时 URL 当永久素材库。
- 7
先用少量不同素材记录实际费用、等待时间与失败原因，再决定批量规模。保留失败样例，不只统计成功任务。
核对本页配置字段与检查项
常见工具配置
- 素材无法读取：检查是否需要公开可访问 URL，过期链接、登录权限和错误 MIME 类型都会影响读取。
- 任务已提交但客户端超时：优先查询任务状态，不立即重复扣费提交。
- 生成失败：保存脱敏错误码、任务 ID 和参数，区分模型限制、内容审核、余额、限流与上游故障。
- 准备素材
确认素材使用权、尺寸与提示词，再选择模型
- 提交并查询任务
保留任务 ID，按文档查询状态，避免重复付费提交
- 验收与保存
检查画面、时长和结果状态，及时保存可用文件
- 响应包含有效结果
- 文本请求有可读取的输出；异步任务需要继续查询到完成状态，不能只把提交成功当作生成成功。
- 日志与请求对得上
- 核对调用时间、模型、令牌分组和用量。界面与账单显示不同货币时，先确认计价口径。
- 原工具中也能重复完成
- 最小示例成功但工具失败，优先检查工具的协议、模型映射和配置生效位置。反馈问题时隐藏完整 Key、Cookie 和个人数据。
常见问题
图生视频提交后一直等待怎么查询任务？
保存创建接口返回的任务 ID，使用同一供应商和版本的查询接口，按允许的间隔轮询并设总等待上限。Seedance 2.0 的 /api/v3 与旧版 /volc/v1 不能混用；具体状态字段按相应文档核对。
图生视频超时应该重新生成吗？
先查询已有任务是否仍在运行或已经完成，再检查返回的失败原因。只有确认未成功且允许重试时才重提；失败是否计费以具体模型规则和账单为准。
所有视频模型都能接收同一套参数吗？
不能。先查看该模型对应接口的必填字段、格式和时长限制。控制台展示名称也不一定是 API 的模型 ID。
失败任务一定不收费吗？
不能统一保证。依据具体模型的计费规则和实际账单核对，不根据客户端是否显示视频判断是否收费。
应该选择哪个模型？
先按图片输入支持、目标画幅、时长、预算和人物一致性筛选，用相同素材做小样测试。不要仅按首页演示视频判断适合你的任务。
把选好的模型，接入你的应用
从 Claude、GPT、Gemini 等模型中选择所需能力。获取 API Key，按工具配置接口地址，再用一个小请求确认结果和费用。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。