1. 网页工作台选择模式与素材
登录后进入“视频”，选择模型、模式、分辨率、时长和比例。需要素材时先上传，再获取本次报价。修改参数后需重新报价；确认费用和余额后提交。
| 模式 / API mode | 所需参考 |
|---|---|
| 文生 / text | 不上传参考素材 |
| 图生 / image | 一张 first_frame 图片 |
| 首尾帧 / frames | first_frame 与 last_frame 各一张 |
| 数字人 / avatar | 一张 reference_image，可选 reference_audio |
| 多模态 / reference | 最多 9 张参考图、3 段参考视频、3 段参考音频 |
2. 核对参数与上传限制
H3 参数范围为 4–15 秒，720P / 1080P / 2K；比例为 adaptive、21:9、16:9、4:3、1:1、3:4、9:16。可用费率和实际组合先查询模型目录，不能将参数声明当作全组合实测。
- JPG/PNG 与 MP3/WAV 最大 3,000,000 字节；MP4 最大 5,000,000 字节。图片宽高均须为 256–5760 像素。
- 网页会尝试调整图片尺寸；API 客户端应在上传前自行处理。使用本人上传、未过期的 ref ID，不直接提交远程素材 URL。
- 只提交有权使用的素材，并遵守本站内容规则。
3. API 查询目录并取得报价
API 使用本站 API Key，通过 Authorization: Bearer 认证；先 GET /v1/videos/models 核对当前可用模型及费率。需要素材时，以 multipart file 上传到 POST /v1/videos/references。下面是无需参考素材的报价示例，环境变量 AK47_API_KEY 由你自己的安全环境提供。报价默认有效 5 分钟，本步骤不扣生成费用。
curl https://ak47token.com/v1/videos/quotes \
-H "Authorization: Bearer $AK47_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"minimax-h3","mode":"text","prompt":"A blue robot waves.","duration":4,"resolution":"720P","ratio":"16:9"}'4. 使用同一份参数创建任务
将报价返回的 ID 填入 quote_id，保持模型、提示词、模式、时长、分辨率、比例和素材与报价一致。为一次生成准备唯一 Idempotency-Key，创建成功返回 202。下方创建会发起实际生成并按规则预扣费用。
- 网络异常后保留原幂等键与参数核查或重试，不要换键重复生成。
- 同一幂等键与不同参数冲突会返回 409；报价过期或参数变更需重新报价。
curl https://ak47token.com/v1/videos \
-H "Authorization: Bearer $AK47_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: REPLACE_WITH_YOUR_UNIQUE_REQUEST_ID' \
-d '{"model":"minimax-h3","mode":"text","prompt":"A blue robot waves.","duration":4,"resolution":"720P","ratio":"16:9","quote_id":"REPLACE_WITH_QUOTE_ID"}'5. 查询任务、核对费用并下载
使用 GET /v1/videos/:id 查询本人任务；成功且账务完成后，GET /v1/videos/:id/content?download=1 下载私有 MP4。API 使用原 Key，网页使用本人登录状态。生成的作品永久保留，可随时查看、下载或主动删除。
| 状态 | 如何处理 |
|---|---|
| pending / queued / submitting / running / archiving | 继续查看原任务，不重复生成 |
| succeeded 且账务已结算 | 下载作品，并核对参数与实际费用 |
| failed 且仍为 reserved | 继续查看退款结果，直到 refunded |
| submission_unknown / review_required | 保留任务编号联系支持，等待核对 |
- 视频秒价与确认时长用于结算。1 发 = 1,000,000 微单位，440000 微单位等值 ¥0.44。
- 2026-10-18 的 4 秒测试 MP4 容器约 4.458 秒，按确认 4 秒计费；不要自行按容器时长进位推算费用。
- 遇到问题提供任务编号、时间、模型及脱敏错误，不提供 API Key 或 Cookie。