O
数字人视频
NEW
调用 ID
在请求体的「model」字段里填这个值 —— 不是上面的展示名。
视频生成闭源
by other · 数字人视频:选一个数字人形象 + 一段驱动音频(或文字驱动)→ 开口说话的数字人视频(异步任务)。按视频时长计费。
快速调用
接口地址
POST /v1/videos/generations调用方式异步任务:提交拿 id,再轮询到终态
Base URL
https://qd.zsopc.com/v1① 提交任务 · cURL
curl https://qd.zsopc.com/v1/videos/generations \
-H "Authorization: Bearer sk-gpushare-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "dh-avatar",
"avatar": "<POST /v1/videos/avatars 拿到的形象 id>",
"audio_url": "https://example.com/voice.mp3",
"duration": 32
}'
# 返回 {"id": "...", "status": "queued"}
# duration 必填(秒):预留费用的依据,缺省直接 400
# 也可以用「文字 + 音色」驱动,不必先合成音频:
# {"model":"dh-avatar","avatar":"…","voice":"<音色 id>","text":"大家好…","duration":30}
# 中文口播时长约 = 字数 ÷ 3.3
# ⚠️ 外部 key 的预扣取「300 秒地板」与你传的 duration 的较大者② 轮询结果 · cURL
curl https://qd.zsopc.com/v1/videos/generations/$TASK_ID \
-H "Authorization: Bearer sk-gpushare-xxxxxxxx"
# status: queued -> running -> succeeded / failed / expired / cancelled
# 建议 5-10 秒轮询一次。轮询免费。这是异步任务:提交拿到任务 id,再轮询到终态。轮询本身免费。
计费
按成片秒数计费:分辨率分档的 SKU 按交付分辨率取对应档单价。
- 价目
- 每秒 3.962积分
- 结算方式
- 提交预扣(取「300 秒地板」与你传的 duration 的较大者)→ 完成按实测时长结算 → 差额退回
- 该 SKU 的成片时长由源媒体决定,提交时按「300 秒预扣地板」与你传的 duration 取大者预扣,完成后按实测时长结算,多扣的退回。
- 所以发起前请确保余额足够覆盖这笔预扣(至少 300 秒的量),否则会直接返回 402。
- duration 为必填,请传驱动音频 / 文字的实际秒数,缺省会直接返回 400。
- 失败 / 过期的任务全额退回。
- 轮询任务状态免费,不计入用量。
- 余额由你名下全部 API Key 共享;余额不足时接口返回 HTTP 402 quota_exceeded。
登录后,若你的账号有专属折扣会显示在这里。 去登录
能力与规格
- 类别
- 视频生成
- 端点族
- 视频生成 (Videos)
- 发布时间
- 2026-07-24
- 许可
- 闭源
试一试
这类模型按张 / 按秒 / 按次真实计费,而且多为异步任务,所以本页不提供一键测试。用上方的示例代码调用,或去对应工作台生成(工作台带参数面板与费用预估)。
打开工作台常见错误
404 model_not_found你填的是展示名,不是调用 ID。✗ 数字人视频→✓ dh-avatar
→ 复制本页顶部的「调用 ID」
402 quota_exceeded账户余额不足。余额由你名下全部 API Key 共享。
→ 去账户页充值
401 / 403API Key 无效,或该 Key 设了模型白名单且不含这个 ID。
→ 检查 Key 的状态与允许模型
400 invalid_requestLite(-lite)SKU 的 resolution 是必填,词表仅 720p / 1080p;传其它档同样 400。
→ 对照上方示例代码检查请求体