#查询状态与下载视频(即梦格式)
#端点
POST /jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31
#请求体
查询结果用 POST 请求,任务 ID 放在 body 里:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
task_id | string | 是 | 创建接口返回的任务 ID |
#请求示例
cURL
Python
Node.js
# 查询任务结果
curl -X POST "https://api-model.shuntianchuang.cn/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31" \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{ "task_id": "task_xxxxxxxx" }'
# 任务 SUCCESS 后,从 data.result_url 取视频直链下载
curl -o jimeng.mp4 "data 中返回的视频URL"import time
import requests
BASE = "https://api-model.shuntianchuang.cn"
RESULT_URL = f"{BASE}/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31"
HEADERS = {"Authorization": "Bearer sk-你的令牌"}
task_id = "task_xxxxxxxx" # 提交响应中的 id / task_id
while True:
data = requests.post(
RESULT_URL, headers=HEADERS, json={"task_id": task_id}
).json()["data"]
print(data["status"], data.get("progress", ""))
if data["status"] in ("SUCCESS", "FAILURE"):
break
time.sleep(10)
if data["status"] == "SUCCESS":
with open("jimeng.mp4", "wb") as f:
f.write(requests.get(data["result_url"]).content)
print("已保存 jimeng.mp4")
else:
raise SystemExit(f"任务失败:{data.get('fail_reason')}")import fs from 'node:fs';
const BASE = 'https://api-model.shuntianchuang.cn';
const RESULT_URL = `${BASE}/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31`;
const HEADERS = {
Authorization: 'Bearer sk-你的令牌',
'Content-Type': 'application/json',
};
const taskId = 'task_xxxxxxxx'; // 提交响应中的 id / task_id
let data;
while (true) {
const resp = await fetch(RESULT_URL, {
method: 'POST',
headers: HEADERS,
body: JSON.stringify({ task_id: taskId }),
});
data = (await resp.json()).data;
console.log(data.status, data.progress ?? '');
if (data.status === 'SUCCESS' || data.status === 'FAILURE') break;
await new Promise((resolve) => setTimeout(resolve, 10_000));
}
if (data.status !== 'SUCCESS') throw new Error(`任务失败:${data.fail_reason}`);
const video = await fetch(data.result_url);
fs.writeFileSync('jimeng.mp4', Buffer.from(await video.arrayBuffer()));#响应体
查询响应为统一任务 JSON,关键字段如下:
data 字段 | 说明 |
|---|---|
task_id | 任务 ID |
status | 状态流转:NOT_START(已提交待处理)→ QUEUED / SUBMITTED(排队、已提交)→ IN_PROGRESS(生成中)→ SUCCESS(成功)或 FAILURE(失败) |
progress | 进度百分比字符串,如 "50%" |
result_url | 成功后的视频下载直链,建议及时下载转存 |
fail_reason | 失败原因 |
#响应示例
{
"code": "success",
"data": {
"task_id": "task_xxxxxxxx",
"status": "SUCCESS",
"progress": "100%",
"result_url": "https://xxxx/video.mp4",
"fail_reason": ""
}
}NOTE
即梦格式的参数由网关映射后转发上游,可用性、计费与响应字段以本站实际响应为准;模型名与价格以模型广场显示为准。计费按任务完成时的实际用量结算(失败自动退还)。
