视频生成 API
Wan 2.6 文生视频、实际时长计费、异步任务及下载
当前完成事务计费接入的精确型号是 wan2.6-text-to-video。先创建 DGlink API Key,确认账户有余额,且密钥允许此模型。DEELINK_API_BASE_URL 已包含 /v1。
一次最低规格测试
curl "$DEELINK_API_BASE_URL/videos/generations" \
-H "Authorization: Bearer $DEELINK_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: <本次请求的唯一编号>" \
-d '{
"model": "wan2.6-text-to-video",
"prompt": "A white ceramic cup on a green table, gentle steam, locked camera",
"duration": 2,
"quality": "720p",
"aspect_ratio": "16:9",
"prompt_extend": false
}'这是一次真实计费请求。提交后保存返回的公开 task_... 任务号;提交成功不代表视频已完成。
curl "$DEELINK_API_BASE_URL/tasks/<公开任务号>" \
-H "Authorization: Bearer $DEELINK_API_KEY"间隔数秒查询,直到任务成功或明确失败。结果在任务响应和任务列表中查看;文件归档到 DGlink 存储,下载仍需本账户登录或客户密钥授权。不要分发上游密钥或供应商原始链接。
参数范围
| 参数 | 当前支持 |
|---|---|
prompt | 去除首尾空白后 1–1500 字符 |
duration | 2–15 秒整数,默认 2 |
quality | 720p(默认)、1080p |
aspect_ratio | 16:9(默认)、9:16、1:1、4:3、3:4 |
prompt_extend | 可选布尔值,不填则省略 |
分辨率字段是 quality,不是 resolution。本通道一次生成一个视频,不接受参考图、参考音视频、批量数量、客户端回调、任意嵌套 model_params 或其他未定价参数。网页表单、JSON 模式和复制示例使用同一白名单。
价格和结算
模型详情的价格页分别展示普通/VIP、720p/1080p 的每秒售价。账户档位由服务端确定,不能通过请求参数伪造;显示价格不等于用户已经拥有 VIP。
提交时冻结价格版本、账户档位和额度换算,并预扣所选时长的额度。成功归档后,按实际视频画面轨道时长结算,多退少补;不会把音轨尾部长度当成新增画面计费。时长读取失败、余额不足以补扣或结算失败时,不伪造“结算成功”,保留任务待核对。额度采用整数最小单位,存在向上取整。
余额、任务、客户用量和经营账本在同一结算事务中更新,重复查询不会重复扣款。后台供应商成本在未取得可信账单前仍是“预计成本”,并非最终对账成本。
重试与异常
同一请求必须重用同一个 Idempotency-Key,且请求体一致。已保存任务返回原任务号;提交中的并发重试可能返回 409。不要因超时创建新编号重复付费。
上游明确拒绝或任务明确失败时退回客户预扣;网络中断、未知上游结果不等于失败,不自动重复创建视频或盲目退款。先查原任务与用量,再联系管理员核对。
验证范围
2026-10-01 已使用客户 API 实际验证一次 2 秒、720p、16:9 文生视频,含轮询、幂等、归档下载和结算。1080p、较长时长及其他宽高比已经实现参数/报价校验,但本次没有逐项产生付费视频验证。
wan2.6-image-to-video 等其他型号的参数草稿不代表其事务计费已经启用,也不等于全部视频模型均已实测。请以本站发布的有效型号为准。
上游契约:Wan 2.6 文生视频说明。