API 接入指南
视频转分镜提示词
从视频提取分镜描述和生成提示词。
复用 POST /api-platform/v1/video-to-prompt,传公网 videoUrl,可选 language(默认 zh-cn)及 maxScenes(1–100 的整数)。也可用 multipart/form-data 上传一个 videoFile。最长 30 分钟。现有服务按每 30 秒向上取整计量,使用 GET /tools 返回的当前 API 单价;旧文档按分钟计费的说明已修正。
curl 'https://aihub-admin.aimix.pro/api-platform/v1/video-to-prompt' \
-H "Authorization: Bearer $PIXMIND_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"videoUrl":"https://example.com/input.mp4","language":"zh-cn","maxScenes":10}'const response = await fetch("https://aihub-admin.aimix.pro/api-platform/v1/video-to-prompt", {
method: "POST", headers: {Authorization: `Bearer ${process.env.PIXMIND_API_KEY}`, "Content-Type": "application/json"},
body: JSON.stringify({videoUrl: "https://example.com/input.mp4", language: "zh-cn", maxScenes: 10})
});
const created = await response.json();
if (!response.ok || created.code !== 1000) throw new Error(created.message);
console.log(created.data.taskId);import os, requests
response = requests.post("https://aihub-admin.aimix.pro/api-platform/v1/video-to-prompt",
headers={"Authorization": "Bearer " + os.environ["PIXMIND_API_KEY"]},
json={"videoUrl": "https://example.com/input.mp4", "language": "zh-cn", "maxScenes": 10}, timeout=120)
response.raise_for_status()
created = response.json()
if created["code"] != 1000: raise RuntimeError(created["message"])
print(created["data"]["taskId"])查询 GET /api-platform/v1/tasks/{taskId}。status:"ready" 时 result 返回现有结构化分镜;status:"failed" 时返回 errorMessage。在线调试展示完整 JSON,可复制和下载。保留原结果结构,以便读取场景描述、总提示词及逐镜头提示词。参见异步任务和临时上传。
该创建接口保留原有行为,不支持本次为净化和 TTS 新增的幂等协议。创建成功后保存任务 ID 并轮询,状态不确定时不要自动重复提交付费请求。