接入与迁移

只需要改两样:
  • 域名:AI MediaKit 系列把 Base URL 换成 https://api.looprouter.com/api/aimediakit;VOD 系列换成 https://api.looprouter.com/api/vod。
  • 密钥:AI MediaKit 用控制台创建的 sk- API Key;VOD 用控制台获取的 AK/SK。
请求路径、参数、响应结构与官方一致,已有代码与官方 SDK 无需改动签名 / 解析逻辑。
  • AI MediaKit(插帧 / 字幕擦除 / 画质增强):请求头携带 Authorization: Bearer sk-你的APIKey,在 控制台 → 令牌 创建。
  • VOD(漫剧转绘):使用 AK/SK 签名(与火山官方签名方式一致),AK/SK 在控制台获取,直接填入官方 SDK 即可。
依次检查:
  1. 接入域名是否为 api.looprouter.com(不是 looprouter.com 主站域名);
  2. AK/SK 是否为控制台获取的当前有效凭据,有没有多余空格;
  3. SDK 的 region 是否保持官方默认 cn-north-1。

视频来源与成片

提供一个公网可直接访问的 http(s) 视频链接(最长 1024 字符),不支持 base64 内联数据。带鉴权、防盗链或仅内网可访问的链接会导致任务失败。
约 2 小时。所有能力返回的成片链接(MediaKit 的 result.video_url、VOD GetPlayInfo 的 MainPlayUrl)均为临时链接,请在任务成功后尽快下载并转存到你自己的存储。下载时无需携带鉴权信息。
链接失效前可重新调用查询接口获取;但成片文件本身也会在生成约 2 小时后清理,届时即使拿到链接也无法下载。请务必在任务成功后尽快下载。

计费

按实际用量后付费(与火山官方一致):提交任务时不预扣、不冻结额度;任务成功后按实际输出时长 × 输出分辨率档位计费,从账户余额中扣除。
不会。任务失败时(包括源视频下载失败、参数在处理阶段校验不通过等)不产生任何费用。
账户余额不足或超出可用额度。请在 控制台 充值后重试。

任务与轮询

处理为异步任务,耗时随视频时长、分辨率与所选能力变化,通常为分钟级。建议 MediaKit 任务每 5–15 秒轮询一次,漫剧转绘每 10–30 秒轮询一次。
单个账户的未完成任务数有上限,超过会返回 429。请等待已有任务完成后再提交新任务。
成片尚未就绪。请先确认 GetVCreativeTaskResult 的 Status 已是 success,再用 OutputJson 中的成片 Vid 调用 GetPlayInfo;若刚成功,稍等片刻重试即可。

参数排错

fps 需满足三个条件:取值在 [15, 120] 区间;大于源视频帧率;不超过源帧率的 4 倍。例如源视频 24 fps,合法目标为 24–96 fps。前一条在提交时校验,后两条在处理阶段校验(不满足时任务失败并全额退款)。
这两个参数有版本限制:scene 仅标准版(tool_version=standard)接受;bit_depth 仅专业版(tool_version=professional)接受。大模型版两者都不支持。
两者至多提供其一:bitrate 指定具体码率(kbps),bitrate_level 指定档位(low/medium/high)。同时提供会返回参数错误。
当前请改用 resolution 指定输出分辨率档位(如 720p / 1080p / 2k)。
ParamObj.input 必须形如 vid://<Vid>,其中 Vid 是步骤 2 QueryUploadTaskInfo 返回的媒资 Vid(不要漏掉 vid:// 前缀,也不要填 JobId 或任务 ID)。
480p / 720p / 1080p 三档。style 为可选的风格描述(最长 100 字符),留空使用默认风格。
还有其他问题?联系商务或在 控制台 提交工单。