ImagoCloud
登录 注册
口播渲染 · 提交渲染任务

提交渲染任务

提交口播渲染任务，异步出片。提交时按 videoUrl 底视频秒数预扣，完成后按成片秒数结算。传素材（materialUrls）则 AI 自动识别剪辑后包装，不传则纯包装。

服务正常 口播渲染 包装 ¥0.01 / 秒带素材剪辑 +¥0.01 / 秒

接口信息

接口地址 https://imago.luznkj.com/v1/jobs
请求方式POST
返回格式application/json

请求 Header

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

请求 Body

名称必填类型说明
compositionId 是 string 模板 ID，见「模板列表」
title 否 string 顶部标题（选填，不传则成片不显示标题）
persona 否 string 人设 / 副标题
videoUrl 是 string 口播底视频 HTTPS 地址
bgmUrl 否 string 背景音乐 HTTPS 地址
captions 是 array 字幕数组：text / start / end（单位秒；若误传毫秒且明显大于视频时长，API 会自动 /1000 纠正），可选 highlights、en
materialUrls 否 array 素材链接（选填，≤5 条，图片/视频均可）。传了就由 AI 按文案自动匹配并剪辑进画面（画中画 + 关键句整屏），不传 = 纯包装
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"]
}'