视频生成 API 文档

模型清单是公开的，写第一行代码前先看看有哪些模型、什么参数：

# 1. 拿模型清单（无需 Key）
curl https://vimo.asia/api/v1/models

# 2. 创建生成任务
curl https://vimo.asia/api/v1/videos/generations \
  -H "Authorization: Bearer sk-你的API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jiasuapi-sd-2-5-j3-doubao",
    "prompt": "镜头缓慢推进，清晨的山谷",
    "seconds": 30,
    "aspect_ratio": "16:9",
    "resolution": "720P",
    "client_request_id": "order-0001"
  }'

# 3. 查状态（video_url 带上同一把 Key 即可下载）
curl https://vimo.asia/api/v1/videos/generations/任务ID \
  -H "Authorization: Bearer sk-你的API_KEY"

除 GET /models 外，所有接口都通过请求头鉴权。Key 在「API 中转」页创建， 完整明文只在创建时显示一次，请妥善保存；丢失只能吊销后重建。

Authorization: Bearer sk-你的API_KEY

部分网络环境（如经过本平台网关）会改写 Authorization 头，此时可改用等价的自定义头：X-Api-Key: sk-你的API_KEY。 两个头服务端都会识别，推荐按你的实际网络环境二选一。

说明：video_url 是站内代理地址而不是供应商临时链接 —— 临时链接会过期、且多数要求鉴权头，交给程序保存毫无意义。 代理地址长期有效，下载时带上你的 API Key 即可。

带上 client_request_id 时，同一账户、同一编号、同一参数只会真正生成一次：

• · 重试 / 网络超时后重发：返回原任务（响应头 X-Idempotent-Replay: true）， 不会重复扣费；
• · 同一编号换了参数（不同模型 / 时长 / 提示词）：返回 409，请更换编号；
• · 不传编号：每次调用都是新任务。

错误响应统一为 { "error": { "code", "message" } }，message 为中文说明， 程序判断请以 code 为准。

此外与站内用户共享提交并发限制（同时在跑的视频任务数）， 具体余量见 GET /account 的 rate_limit 字段。

创建任务时传 callback_url（HTTPS）， 生成完成或失败时会向该地址 POST 一个事件。失败自动重试 3 次（1s / 4s / 16s 退避）， 单次超时 10 秒。

每个请求带签名头：

X-Vimo-Event: video.completed | video.failed
X-Vimo-Signature: t=<unix秒>,v1=<hex>

验签方式：用创建 Key 时拿到的 webhook_secret，对 t + "." + 原始请求体 做 HMAC-SHA256，与 v1 比对；并拒绝 t 超过 5 分钟的报文（防重放）。

import { createHmac } from "node:crypto";

function verify(rawBody, header, secret) {
  const m = /^t=(\d+),v1=([0-9a-f]+)$/.exec(header);
  if (!m) return false;
  const [, t, v1] = m;
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false; // 防重放
  const expected = createHmac("sha256", secret)
    .update(t + "." + rawBody, "utf8")
    .digest("hex");
  return expected === v1;
}

事件体：{ id, object: "event", type, created, data: { id, object: "video", status, model, video_url, usage, error? } }。

• · 创建成功即按「单价 × 秒数（或按次）」预扣积分，与站内生成同价；
• · 生成失败（上游明确失败 / 参数被拒）自动全额退还，usage.refunded 可见退还数；
• · 上游受理后会一直排队并查询到出结果或上游明确失败，平台不会自动重发；提交未成功则立即全额退款；
• · 余额查询：GET /account。

以下为当前开放的视频档位（实时读取，以后台停用为准）。价格为积分： 按秒档位是「积分/秒」，按次档位是「积分/次」。

字段命名遵循 OpenAI 视频 API 惯例。如果你从星创等站点迁来，对照如下：