API 文档

使用你自己的 API Key 调用即刻生彩接口。每个 Key 只代表创建它的用户,只能访问该用户自己的素材与任务。字段、响应和完整示例请查看 完整协议接入文档。

服务端调用时使用 Authorization: Bearer YOUR_API_KEY。密钥仅在创建成功时显示一次,服务器只保存 SHA-256 摘要。

我的 API Key

检查登录状态…
请稍候
读取中

鉴权方式

HEADERAuthorization: Bearer sk-xpqmm-...

推荐方式。也兼容请求头 X-API-Key: sk-xpqmm-...。不要把 API Key 放入网址查询参数或公开的前端代码。

可调用接口

GET/api/models

获取当前可用视频模型、面向用户的 price、计价单位 price_unit,以及支持的时长、分辨率和参考素材数量。渠道成本价不会通过用户接口公开。

POST/api/media

以 multipart/form-data 上传图片、视频或音频,文件字段名为 file。返回的素材 ID 用于生成请求中的 references。

POST/api/media/validate

生成前一次校验全部素材 ID。只有 invalid_ids 为空且 valid_ids 数量与素材节点总数一致时才提交视频。

POST/api/videos

提交视频任务。除 model、prompt、seconds、aspect_ratio、resolution 和 references 外,新接入应同时提交 text_nodes、reference_manifest 和期望数量校验字段。服务端会返回 input_receipt,用于确认素材和提示词没有遗漏。

GET/api/videos/{task_id}

查询属于当前 API Key 用户的视频任务状态。

GET/api/videos/{task_id}/download-ticket

任务成功后取得 15 分钟有效的签名下载地址,不需要在浏览器中暴露 API Key。

GET/api/videos/{task_id}/content?download=1

任务完成且 video_available=true 后下载生成的视频。

GET/api/tasks?limit=50

读取当前用户自己的任务记录,最多返回 100 条。

调用示例

完整链路:刷新模型 → 逐个上传全部图片/视频/音频节点 → 批量校验素材 ID → 提交全部提示词和素材清单 → 核对 input_receipt → 轮询任务 → 下载视频。任何数量或提示词摘要不一致时,接口会停止提交,不会静默漏字段。
curl https://xpqmm.lol/api/models \
  -H "Authorization: Bearer <API_KEY>"
curl https://xpqmm.lol/api/media \
  -H "Authorization: Bearer <API_KEY>" \
  -F "file=@reference.png"
curl https://xpqmm.lol/api/media/validate \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"ids":["media_image_id","media_video_id","media_audio_id"]}'
curl https://xpqmm.lol/api/videos \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"VIDEO_MODEL_ID","prompt":"保持角色和场景连续","text_nodes":[{"node_id":"text-1","label":"镜头一","text":"人物走向窗边,镜头缓慢推进"}],"references":["media_image_id","media_video_id","media_audio_id"],"reference_manifest":[{"media_id":"media_image_id","kind":"image","label":"角色图","node_id":"asset-1"},{"media_id":"media_video_id","kind":"video","label":"动作参考","node_id":"asset-2"},{"media_id":"media_audio_id","kind":"audio","label":"对白参考","node_id":"asset-3"}],"expected_reference_count":3,"expected_text_node_count":1,"seconds":10,"aspect_ratio":"16:9","resolution":"720p","generate_audio":true}'
curl "https://xpqmm.lol/api/videos/TASK_ID/download-ticket" \
  -H "Authorization: Bearer <API_KEY>"