即映镜
陈

API 服务

同一套模型,用 HTTP 接进你的生产流程。创建任务、轮询状态、取回结果地址。

Base URL

https://api.jiyingjing.example.com

示例地址,未开通真实密钥

鉴权方式

Authorization: Bearer <KEY>

在「管理 → 秘钥管理」中配置密钥后使用

请求格式

application/json

请求体统一为 JSON,响应为 JSON

可调用能力

以下路径为接口契约示意,未开通真实密钥

文生视频

按秒折算映点

文本直接生成 5–15 秒视频,支持画幅与时长参数

POST /v1/videos

图生视频

按秒折算映点

首帧加提示词生成镜头,可选尾帧做收口

POST /v1/videos/image

文生图 / 图生图

按张折算映点

单图或批量生成,支持参考图与局部重绘

POST /v1/images

视频超分

按秒折算映点

生成式重建到 2K,保留原帧率与音轨

POST /v1/videos/upscale

配乐生成

按次计费

按情绪与时长生成配乐,输出可商用标记

POST /v1/music

任务查询

不计费

轮询任务状态与结果地址,支持批量查询

GET /v1/tasks/{id}

端点一览

表格可横向滑动

方法路径说明参数
POST/v1/videos创建视频生成任务model · prompt · ratio · duration · refs
POST/v1/images创建图片生成任务model · prompt · size · count
POST/v1/videos/upscale提交超分任务video_url · target · keep_audio
GET/v1/tasks/{id}查询任务状态id
GET/v1/models列出可用模型与配额type

请求与响应

请求示例

curl -X POST https://api.jiyingjing.example.com/v1/videos \
  -H "Authorization: Bearer <KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jiying-video-v3",
    "prompt": "深夜便利店门口,雨中霓虹,35mm 中景,轻微手持",
    "ratio": "9:16",
    "duration": 10,
    "refs": { "images": [], "videos": [] }
  }'

密钥获取:在「管理 → 秘钥管理」中配置密钥后使用,请求头按 Bearer 方式携带。

响应示例

任务创建 · 202 Accepted

HTTP/1.1 202 Accepted

{
  "id": "task_8f21c4",
  "status": "queued",
  "model": "jiying-video-v3",
  "estimated_seconds": 42
}

任务完成 · 200 OK

HTTP/1.1 200 OK

{
  "id": "task_8f21c4",
  "status": "succeeded",
  "model": "jiying-video-v3",
  "output": {
    "url": "https://cdn.jiyingjing.example.com/v1/task_8f21c4.mp4",
    "cover": "https://cdn.jiyingjing.example.com/v1/task_8f21c4.jpg",
    "duration": 10,
    "ratio": "9:16",
    "width": 1080,
    "height": 1920
  },
  "usage": { "seconds": 10, "credits": 11 },
  "created_at": "2026-11-16T09:12:03Z",
  "finished_at": "2026-11-16T09:12:51Z"
}

成功响应的 output 含 mp4、封面与分辨率,usage 为本次实际扣减的秒数与映点,可直接用于对账。

任务轮询与状态

视频类任务异步返回,查询到终态再取结果

轮询示例 · 退避与终态判断

async function waitTask(id) {
  let interval = 2;
  for (let i = 0; i < 300; i += 1) {
    await new Promise((resolve) => setTimeout(resolve, interval * 1000));
    const res = await fetch(`https://api.jiyingjing.example.com/v1/tasks/${id}`, {
      headers: { Authorization: "Bearer <KEY>" },
    });
    if (res.status === 429) {
      interval = Number(res.headers.get("retry-after") || interval * 2);
      continue;
    }
    const task = await res.json();
    if (["succeeded", "failed", "canceled"].includes(task.status)) return task;
    interval = Math.min(Math.round(interval * 1.5), 10);
  }
  throw new Error("轮询超过 15 分钟,请改用回调查询");
}

创建任务后拿到 id 即可开始轮询;不要在创建请求上同步等待结果。

进行中 · 200 OK

HTTP/1.1 200 OK

{
  "id": "task_8f21c4",
  "status": "running",
  "model": "jiying-video-v3",
  "progress": 0.62,
  "suggested_poll_interval": 3,
  "estimated_seconds_remaining": 16
}

suggested_poll_interval 由服务端按队列压力给出,优先于本地固定间隔。

状态终态客户端动作
queued排队中否创建成功即可开始轮询,建议 2 秒一次,不要用固定高频请求。
running生成中否按响应里的 suggested_poll_interval 调整间隔,用 progress 驱动前端进度条。
succeeded已完成是取 output.url 与 output.cover 转存到自有存储,示例地址 24 小时内有效。
failed失败是读 error.code 与 error.message 修正参数后重建任务,预占映点自动退回。
canceled已取消是调用取消接口或超时清理后的终态,不再轮询,可重新创建。
  • 轮询间隔从 2 秒起,按 1.5 倍退避,上限 10 秒;单任务最多轮询 15 分钟。
  • 收到 429 时读 retry-after 再请求,不要并发叠加轮询。
  • 终态之后才结算映点:成功按实际时长,失败随之退回。
  • 结果地址为临时地址,接入方应转存到自有存储后再对外分发。

错误码

状态码含义处理建议
401密钥无效或未配置在「管理 → 秘钥管理」中重新生成并按 Bearer 方式放入请求头
402映点不足在会员与映点页充值加油包后重试
429超出并发或速率限制按返回的 retry-after 退避,或降低并发数
422参数校验失败检查 duration、ratio 与参考素材数量是否在该模型范围内

速率与计费

并发

默认同一账号 4 路并发任务,超出的请求返回 429,不会排队静默丢弃。

退避

遇到限流按响应头 retry-after 退避,建议指数退避从 2 秒起步,最多重试三次。

映点扣减

任务创建即预占映点,成功按实际时长结算,失败在轮询结果返回时退回。

示例站点未开通密钥签发与计费,以上为接口契约示意。

接入前先跑通一条链路

先用工作流看清任务怎么被创建、轮询与取回,再决定调用哪个端点。