1. 基本信息
Base URL
__API_BASE__
鉴权方式
Authorization: Bearer sk-你的APIKey
所有请求使用 HTTPS，鉴权头固定为
Authorization: Bearer sk-...。API Key 在用户面板「令牌」中创建，令牌所在分组决定能调用哪些模型。接口一览
| 接口 | 方法 | 说明 |
|---|---|---|
/v1/models | GET | 查询当前 Key 可调用的模型列表 |
/v1/videos | POST | 提交视频生成任务，返回任务 ID |
/v1/videos/{task_id} | GET | 查询任务状态与进度 |
/v1/videos/{task_id}/content | GET | 下载生成的视频（返回视频流） |
确认自己可用的模型
curl -H 'Authorization: Bearer sk-你的APIKey' __API_BASE__/models
在线检测（不会产生任何费用）
填 Key 后点击检测，会用你的 Key 真实调用 /v1/models，只读取模型列表，不生成、不扣费。
2. 上架模型总览
以下为平台当前公开零售模型，按分组展示；分组是平台内部路由用的，调用时只需要模型 ID。价格均为用户实付单价。
内部 / 代理专用 SKU（如
wanzi-*、zxs-*）不对普通用户开放，不在此列出；如果你拿到的是专属账号，请以 GET /v1/models 返回的模型与后台显示的价格为准。模型列表按分组隔离：如果你的 Token 不在某个分组（例如 default），该分组的模型不会出现在
GET /v1/models 中，也无法调用。请始终以 GET /v1/models 返回的列表为准。加载中...
3. 提交任务：POST /v1/videos
POST __API_BASE__/videos Content-Type: application/json Authorization: Bearer sk-你的APIKey
请求字段
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
model | string | 必填 | 模型 ID，必须与 GET /v1/models 返回一致，区分大小写 |
prompt | string | 必填 | 提示词。引用素材时用 @Image1、@Video1、@Audio1 指向第 N 个素材 |
seconds | string | 建议填 | 视频时长（秒）。固定时长模型填其固定值，其余填允许区间内的整数 |
size | string | 建议填 | 画幅尺寸，如 720x1280（竖屏）、1280x720（横屏）、1024x1792 |
aspect_ratio | string | 可选 | 画面比例，如 9:16、16:9、1:1 |
resolution | string | 可选 | 分辨率，如 480p、720p、768p、1080p、4k |
images | string[] | 可选 | 参考图，公网 HTTPS 直链，按顺序对应 @Image1、@Image2 |
videos | string[] | 可选 | 参考视频，公网 HTTPS 直链，对应 @Video1、@Video2 |
audios | string[] | 可选 | 参考音频，公网 HTTPS 直链，对应 @Audio1、@Audio2 |
以上字段为标准调用方式。模型不支持某项能力（例如不支持参考音频）时，请勿传对应字段，否则可能直接失败。
返回值
{
"id": "task_xxxxxxxxxxxxxxxx",
"object": "video",
"status": "queued",
"model": "sd2.0-933-op",
"progress": 0,
"created_at": 1789885832
}
4. 参考素材规则
- 参考图 / 参考视频 / 参考音频都必须是公网可访问的 HTTPS 直链，例如
https://你的图床/a.jpg。 - 不支持
data:内联数据、本地文件路径、内网地址（127.0.0.1、192.168.x.x、localhost）。 - 提示词里用
@Image1、@Video1、@Audio1引用第 N 个素材；素材数组顺序就是编号顺序。 - 各模型的素材数量上限见第 2 节模型卡片，超限会被拒绝或静默截断。
- 建议单个参考视频 ≤ 50MB、累计时长 ≤ 15 秒；参考音频 ≤ 15MB、累计 ≤ 15 秒、单段 ≥ 2 秒。
上游对真人素材有肖像合规限制，部分模型会返回「该模型仅支持生成本人出镜的视频」。这是上游策略限制，与本平台参数无关，可改用纯文本生成或使用本人素材。
5. 查询与下载
查询任务
GET __API_BASE__/videos/{task_id}
Authorization: Bearer sk-你的APIKey
{
"id": "task_xxxxxxxxxxxxxxxx",
"status": "completed",
"progress": 100,
"model": "sd2.0-933-op"
}
status 取值：queued（排队）、in_progress（生成中）、completed（完成）、failed（失败）。建议每 3~5 秒轮询一次。下载视频
GET __API_BASE__/videos/{task_id}/content
Authorization: Bearer sk-你的APIKey
该接口直接返回视频二进制流，浏览器里打开会自动播放，
curl -o out.mp4 可保存为文件。任务未完成时下载会返回错误。6. 完整调用示例
curl · 纯文本生成
curl · 带参考图生成
Python · 提交 + 轮询 + 下载
7. 错误处理与退款
失败自动退款：任务只要没有成功产出视频（上游报错、内容审核拒绝、超时、渠道余额不足等），预扣的费用会自动退回，不会扣你钱。你可以放心重试。
错误响应统一为 JSON，读取 error.message 即可拿到可读原因。
| 错误信息 | 原因与处理 |
|---|---|
invalid token | API Key 错误、被禁用或已删除，检查请求头 |
model not found / 令牌分组 xxx 下模型 yyy 无可用渠道 | 当前 Key 的分组没有该模型权限，用 GET /v1/models 确认真实可用的模型 ID |
all assets must use HTTP(S) URLs | 参考素材不是公网 HTTP(S) 直链，改用图床/CDN 地址 |
当前分组 xxx 下模型 yyy 的令牌额度不足 | 账户余额不足，请充值 |
该模型仅支持生成本人出镜的视频 | 上游肖像合规限制，更换素材或改用纯文本生成 |
| HTTP 502 / 504 | 上游瞬时异常，隔几秒重试同一请求即可 |
上游错误码对照（生成失败时出现）
| 上游返回 | 含义与处理 |
|---|---|
classifier_delivery_unknown | 上游内容审核服务异常（对方偶发故障），本单未计费，稍后重试即可 |
creation_unconfirmed_timeout | 上游创建任务超时，未计费，建议重试 |
upstream submission finished without a task identifier | 上游未返回任务号，未计费，建议重试 |
fail_to_fetch_task | 上游查询任务失败，未计费，可重试 |
| 肖像保护 / 仅支持本人出镜 | 该模型只接受本人形象素材，请更换参考图或改用纯文本生成 |
| 版权保护 | 参考素材疑似有版权限制，请更换素材或修改提示词 |
| 违反平台政策 / InputImageSensitiveContentDetected | 提示词或参考图触发了上游内容策略，请修改后重试 |
| 积分不足 / 渠道余额不足 | 上游供货渠道余额不足，暂时无法出单，请联系管理员 |
| 任务超时（N分钟） | 任务长时间无进度已自动判失败并退款，可重新提交 |
提示：如果同一个提示词/素材反复出现同一错误，先换素材或简化提示词；若仍不行，把任务 ID 发给管理员排查。
生成中的任务失败后会自动退回额度；重复提交会各自计费，请勿在未确认失败前重复提交。
8. 计费说明
- 按条计费模型：一次任务固定扣一次费用，与时长无关。
- 按秒计费模型：以任务实际时长 × 每秒单价扣费。
- 具体单价见第 2 节模型卡片，实际扣费也可以在用户面板日志中核对。
- 按次计费的模型与时长无关；按秒计费的模型按实际时长计费，卡片上会标注。
- 生成失败（含上游报错、审核不通过、超时）自动退款；重复提交会各自计费，请勿在未确认失败前重复提交。