提交渲染任务

接口信息

请求 Header

名称	必填	说明
Authorization	是	Bearer YOUR_KEY（控制台 → API Keys）
Content-Type	否	application/json（POST 时必填）

请求 Body

名称	必填	类型	说明
compositionId	是	string	模板 ID，见「模板列表」
title	否	string	顶部标题（选填，不传则成片不显示标题）。带换行符 \n 时按传入的行渲染；不带时 ≤10 字保持单行，含 ？！。， 等标点或超长时自动拆两行
persona	否	string	人设 / 副标题
videoUrl	是	string	口播底视频 HTTPS 地址
bgmUrl	否	string	背景音乐 HTTPS 地址
captions	是	array	字幕数组：text / start / end（单位秒；若误传毫秒且明显大于视频时长，API 会自动 /1000 纠正），可选 highlights、en。highlights 为字符串数组（该条 text 的连续子串，每词 2~5 字）。只要任一条带了非空 highlights，即视为高亮由调用方策展：未命中 highlights 的句子保持无高亮，系统不再自动/AI 补选高光词
materialUrls	否	array	素材链接（选填，≤5 条，图片/视频均可）。传了就由 AI 按文案自动匹配并剪辑进画面（画中画 + 关键句整屏），不传 = 纯包装。与 materialShots 同时传时 materialShots 优先
materialShots	否	array	结构化分镜（选填，与 materialUrls 并存且优先）。调用方已自行完成「每句口播 ↔ 素材秒段」对齐时使用，传了即跳过 AI 匹配、严格按分镜渲染。每项字段：url 素材 HTTPS 地址；captionIndex 对齐 captions 第几条（1 起，该条时间窗 = 素材出现时间窗）或 text 填该句口播原文（二选一，captionIndex 优先）；in/out 只取素材第几秒到第几秒（浮点秒，选填，缺省 = 整段，in≥out 按缺省处理，素材段比时间窗短时定格尾帧补齐）；mode pip 画中画 / full 整屏（缺省跟随 autoMode，auto 视为 pip）。相邻同素材且素材段连续的分镜会自动合并；合并后 ≤20 条，条目非法（对齐失败 / 时间窗过短）将被忽略
autoMode	否	string	素材呈现规则：auto 关键句自动整屏·默认 | pip 全部画中画 | full 尽量整屏

返回参数

名称	类型	说明
id	string	任务 ID
status	string	queued / running / success / failed
estimate_sec	int	底视频秒数
frozen_yuan	string	预扣金额（元）
price_yuan_per_sec	string	单价（元/秒）

请求示例

curl -X POST https://imago.luznkj.com/v1/jobs \
  -H "Authorization: Bearer ic_xxx" \
  -H "Content-Type: application/json" \
  -d '{
  "compositionId": "01-yellow-banner",
  "title": "说话没人听？记住这3招",
  "persona": "职场表达",
  "videoUrl": "https://cdn.example.com/koubo.mp4",
  "bgmUrl": "https://cdn.example.com/bgm.mp3",
  "captions": [
    {"text":"很多人开口没人听","start":0.15,"end":1.9}
  ],
  "materialUrls": ["https://cdn.example.com/beef.jpg", "https://cdn.example.com/mart.mp4"],
  "materialShots": [
    {"url":"https://cdn.example.com/mart.mp4","in":4.0,"out":8.0,"captionIndex":1,"mode":"pip"}
  ]
}'

复制示例

无数据