文生视频
按秒折算映点文本直接生成 5–15 秒视频,支持画幅与时长参数
POST /v1/videos
同一套模型,用 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已取消 | 是 | 调用取消接口或超时清理后的终态,不再轮询,可重新创建。 |
| 状态码 | 含义 | 处理建议 |
|---|---|---|
| 401 | 密钥无效或未配置 | 在「管理 → 秘钥管理」中重新生成并按 Bearer 方式放入请求头 |
| 402 | 映点不足 | 在会员与映点页充值加油包后重试 |
| 429 | 超出并发或速率限制 | 按返回的 retry-after 退避,或降低并发数 |
| 422 | 参数校验失败 | 检查 duration、ratio 与参考素材数量是否在该模型范围内 |
并发
默认同一账号 4 路并发任务,超出的请求返回 429,不会排队静默丢弃。
退避
遇到限流按响应头 retry-after 退避,建议指数退避从 2 秒起步,最多重试三次。
映点扣减
任务创建即预占映点,成功按实际时长结算,失败在轮询结果返回时退回。
示例站点未开通密钥签发与计费,以上为接口契约示意。