# LoopRouter 文档

> LoopRouter AI API 网关官方文档 — 视频生成、真人素材与 Doubao Seedream 图像接口

- API 接入点: https://api.looprouter.com
- 每个文档页面的 URL 加 `.md` 后缀即可获取该页 Markdown 原文
- 全量文档合并版: https://docs.looprouter.com/llms-full.txt

## 文档页面

- [LoopRouter 文档中心](https://docs.looprouter.com/index.md): LoopRouter — 企业级 AI 视频生成 API 网关，提供与火山引擎完全兼容的 Doubao Seedance 视频生成与素材库接口
- [快速开始](https://docs.looprouter.com/getting-started.md): 三步完成接入：创建 API Key → 提交视频任务 → 轮询获取成片
- [分组说明：VIP 组与补贴组](https://docs.looprouter.com/user-groups.md): VIP 组与补贴组的区别：计费折扣、可用分辨率档位与画质稳定性差异，以及如何选择和切换分组
- [AI 集成指南](https://docs.looprouter.com/ai-usage.md): 让 ChatGPT、Claude 等 AI 助手直接读取本文档站：llms.txt 索引、每页 Markdown 版本与推荐提示词
- [素材库 API](https://docs.looprouter.com/asset-management/asset-library.md): 上传并管理参考素材，获取 asset ID，实现角色一致性视频生成
- [素材引用生视频实战](https://docs.looprouter.com/asset-management/asset-reference.md): 端到端教程：创建素材组 → 注册素材 → 等待 Active → asset:// 引用生成 → 轮询下载成片
- [真人认证接口](https://docs.looprouter.com/asset-management/real-person.md): 真实人像素材的活体认证全流程 API：发起认证、H5 刷脸、查询结果、上传真人素材
- [Seedance 2.0 能力总览](https://docs.looprouter.com/api-capabilities/seedance2/overview.md): Doubao Seedance 2.0 视频生成：模型介绍、技术规格、分辨率与宽高比、计费方式与常见问题
- [Seedance 2.0 视频生成 API](https://docs.looprouter.com/api-capabilities/seedance2/video-generation.md): 任务式异步接口：文生视频、首尾帧图生视频、多模态参考生视频，路径与火山引擎方舟完全一致
- [Seedance 2.5 能力总览](https://docs.looprouter.com/api-capabilities/seedance25/overview.md): Doubao Seedance 2.5 视频生成：素材规格、输出格式与编码、任务类型约束、计费方式与常见问题
- [Seedance 2.5 视频生成 API](https://docs.looprouter.com/api-capabilities/seedance25/video-generation.md): Seedance 2.5 异步视频生成：MP4/MOV 输出、参考生成与编辑/延长参数、素材格式与编码、任务约束
- [万相 3.0 能力总览](https://docs.looprouter.com/api-capabilities/wan3/overview.md): 通义万相 3.0（wan3.0-video / wan3.0-video-prime）全能参考视频生成：模型介绍、技术规格、分辨率与宽高比、最长 30 秒时长、计费方式与常见问题；把 Base URL 指向网关、只换 API Key 即可调用
- [万相 3.0 视频生成 API](https://docs.looprouter.com/api-capabilities/wan3/video-generation.md): 任务式异步接口：文生视频、图生视频、参考生视频；与阿里百炼（DashScope）原生格式完全一致，把 Base URL 指向网关、只换 API Key 即可调用
- [MiniMax-H3 能力总览](https://docs.looprouter.com/api-capabilities/minimax/overview.md): MiniMax-H3（海螺 Hailuo）多模态视频模型：原生 /v2 接口、生成模式、技术规格、提示增强、视频再生与计费说明
- [MiniMax-H3 视频生成 API](https://docs.looprouter.com/api-capabilities/minimax/video-generation.md): 原生 /v2 任务接口：创建、查询、列表、删除，以及提示增强（Context-IR）与视频再生（Regeneration）
- [MiniMax-H3 特惠版](https://docs.looprouter.com/api-capabilities/minimax/h3-special.md): 通过独立 /special/v2 接口使用 MiniMax-H3 特惠版，支持 768P 与 2K 输出
- [可灵 3.0 能力总览](https://docs.looprouter.com/api-capabilities/kling/overview.md): 可灵 3.0（Kling 3.0）系列视频模型：路径式 3.0 接口、六个模型、文/图/Omni 生成、动作控制、数字人、声音复刻与计费说明
- [可灵 3.0 视频生成 API](https://docs.looprouter.com/api-capabilities/kling/video-generation.md): 可灵 3.0 路径式任务接口：文生视频、图生视频、Omni 多模态、动作控制、数字人生成与批量任务查询
- [可灵 3.0 自定义主体 API](https://docs.looprouter.com/api-capabilities/kling/custom-elements.md): 可灵 3.0 高级自定义主体（advanced custom elements / 主体管理）：用参考图或参考视频定义可复用主体，产出 element_id 供 Omni / 动作控制引用，渠道级能力、不计费
- [可灵 3.0 声音复刻 API](https://docs.looprouter.com/api-capabilities/kling/voice-cloning.md): 可灵 3.0 声音复刻（voice cloning）：克隆一段音源的音色，产出可复用的 voice_id，按次计费
- [Doubao Seedream 5.0 Pro 能力概览](https://docs.looprouter.com/api-capabilities/seedream/overview.md): Doubao Seedream 5.0 Pro 的图片生成、参考图编辑、交互编辑、图层拆分与透明背景能力
- [Doubao Seedream 5.0 Pro 图片生成与编辑](https://docs.looprouter.com/api-capabilities/seedream/image-generation.md): Seedream 5.0 Pro 普通模式的公共参数、参考图限制、尺寸规格、输出格式与调用示例
- [Doubao Seedream 5.0 Pro 交互编辑](https://docs.looprouter.com/api-capabilities/seedream/interactive-editing.md): 使用标注图、点坐标与框坐标精确指定 Seedream 5.0 Pro 的图片编辑位置
- [Doubao Seedream 5.0 Pro 图层拆分](https://docs.looprouter.com/api-capabilities/seedream/layer-decomposition.md): 使用 Seedream 5.0 Pro 自动拆分、定向拆分或编辑图片图层，并读取图层位置元数据
- [创建视频生成任务](https://docs.looprouter.com/api-reference/create-video-task.md)
- [查询视频生成任务](https://docs.looprouter.com/api-reference/get-video-task.md)
- [创建视频生成任务（万相 3.0）](https://docs.looprouter.com/api-reference/wan3/create-video-task.md)
- [查询视频生成任务（万相 3.0）](https://docs.looprouter.com/api-reference/wan3/get-video-task.md)
- [创建视频生成任务](https://docs.looprouter.com/api-reference/minimax/create-video-task.md)
- [查询视频生成任务](https://docs.looprouter.com/api-reference/minimax/get-video-task.md)
- [任务列表](https://docs.looprouter.com/api-reference/minimax/list-video-tasks.md)
- [取消 / 删除任务](https://docs.looprouter.com/api-reference/minimax/delete-video-task.md)
- [提示增强 Context-IR](https://docs.looprouter.com/api-reference/minimax/h3-context-ir.md)
- [视频再生 768P → 2K](https://docs.looprouter.com/api-reference/minimax/video-regeneration.md)
- [创建特惠视频任务](https://docs.looprouter.com/api-reference/minimax-special/create-video-task.md)
- [查询特惠视频任务](https://docs.looprouter.com/api-reference/minimax-special/get-video-task.md)
- [特惠任务列表](https://docs.looprouter.com/api-reference/minimax-special/list-video-tasks.md)
- [特惠提示词增强](https://docs.looprouter.com/api-reference/minimax-special/h3-context-ir.md)
- [特惠视频再生成](https://docs.looprouter.com/api-reference/minimax-special/video-regeneration.md)
- [删除已结束的特惠任务](https://docs.looprouter.com/api-reference/minimax-special/delete-video-task.md)
- [文生视频（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/text-to-video.md)
- [图生视频（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/image-to-video.md)
- [Omni 多模态生成（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/omni-video.md)
- [动作控制（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/motion-control.md)
- [数字人提交（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/avatar.md)
- [数字人查询（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/get-avatar.md)
- [声音复刻提交（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/create-voice.md)
- [声音复刻查询（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/get-voice.md)
- [声音复刻列表（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/list-voices.md)
- [创建自定义主体（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/create-custom-element.md)
- [查询自定义主体（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/get-custom-element.md)
- [查询官方预置主体（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/list-preset-elements.md)
- [任务查询（可灵 3.0）](https://docs.looprouter.com/api-reference/kling/list-tasks.md)
- [创建图像生成请求](https://docs.looprouter.com/api-reference/seedream/create-image.md)
- [视频处理总览](https://docs.looprouter.com/video-processing/overview.md): 对已有视频做后期再处理：智能插帧、字幕擦除、画质增强、漫剧转绘。完全兼容火山云官方 API 格式，换域名与密钥即可接入。
- [AI MediaKit 接入说明](https://docs.looprouter.com/video-processing/aimediakit/overview.md): 火山云 AI MediaKit 系列能力的 Base URL、API Key 鉴权、统一响应结构与错误码。
- [智能插帧](https://docs.looprouter.com/video-processing/aimediakit/frame-interpolation.md): 把视频补帧到更高帧率（最高 120 fps），让运动画面更顺滑流畅。兼容火山云 AI MediaKit 官方格式。
- [字幕擦除](https://docs.looprouter.com/video-processing/aimediakit/subtitle-erasure-pro.md): 精细擦除视频画面中的硬字幕与文字，支持指定擦除区域、时间窗与字幕高度过滤。兼容火山云 AI MediaKit 官方格式。
- [画质增强（标准版 / 专业版）](https://docs.looprouter.com/video-processing/aimediakit/enhance-video.md): 提升视频清晰度、色彩与码率表现，最高 8K 输出，专业版支持 10/12/16 位深。兼容火山云 AI MediaKit 官方格式。
- [画质增强（大模型版）](https://docs.looprouter.com/video-processing/aimediakit/enhance-video-generative.md): 大模型驱动的生成式超分增强，最高 2K 输出。兼容火山云 AI MediaKit 官方格式。
- [任务查询](https://docs.looprouter.com/video-processing/aimediakit/get-task.md): 查询 AI MediaKit 系列任务的状态与结果：进行中、成功（成片链接）、失败（错误原因）。
- [VOD 接入说明](https://docs.looprouter.com/video-processing/vod/overview.md): 火山云 VOD 系列能力的 AK/SK 鉴权、Base URL、统一响应结构与错误码。官方 SDK 换域名与密钥即可接入。
- [AI 漫剧转绘](https://docs.looprouter.com/video-processing/vod/comic-style-transfer.md): 把真人 / 实拍视频整体转绘为漫画风格成片。5 步链路：上传 → 查上传 → 提交转绘 → 轮询结果 → 取播放地址。兼容火山云 VOD 官方格式。
- [常见问题](https://docs.looprouter.com/video-processing/faq.md): 视频处理接口的常见问题：接入与迁移、视频来源、成片有效期、计费、参数排错。
- [使用场景总览](https://docs.looprouter.com/scenarios/overview.md): LoopRouter Seedance 视频生成的典型落地场景：电商营销、角色 IP 短剧、真人口播数字人、从火山方舟迁移
- [电商与营销短视频](https://docs.looprouter.com/scenarios/ecommerce-marketing.md): 用 Seedance 2.0 批量生产商品展示、广告 Bumper 与节日营销短视频：文生视频 + 首帧图生视频
- [角色 IP 与短剧一致性](https://docs.looprouter.com/scenarios/character-ip.md): 用多模态参考 + 素材库锁定角色形象，让连续短剧 / IP 系列的多个镜头保持同一主角
- [真人口播与数字人](https://docs.looprouter.com/scenarios/digital-human.md): 真人认证后用本人形象生成口播视频：活体认证 → 上传真人素材 → 台词驱动的口播生成
- [从火山引擎方舟迁移](https://docs.looprouter.com/scenarios/migrate-from-ark.md): 已有火山引擎方舟（Ark）Seedance 代码？只改 Base URL 与 API Key 即可迁移到 LoopRouter
- [模型选择与异步任务](https://docs.looprouter.com/faq/model-and-async.md): 该用哪个模型？为什么创建任务只返回 id 没有视频？succeeded 还是 completed？异步任务与轮询的常见疑问
- [分辨率、宽高比与时长](https://docs.looprouter.com/faq/resolution-ratio-duration.md): 各分组支持哪些分辨率？adaptive 是什么？duration -1 怎么计费？分辨率、宽高比与时长的常见问题
- [并发、限流与重试](https://docs.looprouter.com/faq/concurrency-and-ratelimit.md): 429 是什么意思？并发上限多少？如何指数退避重试？高并发批量生产的限流应对
- [API Key 与鉴权](https://docs.looprouter.com/faq/api-key-and-auth.md): sk- 令牌怎么创建？请求头怎么写？401 / 403 怎么排查？/api 前缀能省略吗？
- [计费、余额与退款](https://docs.looprouter.com/faq/billing-and-balance.md): 预扣结算是怎么算的？哪些情况不扣费？失败任务会退款吗？视频输入折扣是什么？
- [日志、任务查询与保留](https://docs.looprouter.com/faq/logs-and-tasks.md): 怎么查历史任务？日志中心看什么？任务和成片保留多久？如何批量筛选任务
- [真人认证与内容安全](https://docs.looprouter.com/faq/real-person-and-safety.md): 为什么真人照片不能直接用？活体认证怎么走？内容审核会拦什么？素材如何隔离
- [网络、下载与常见报错](https://docs.looprouter.com/faq/network-and-download.md): 视频链接过期怎么办？下载要不要带 Authorization？Python JSON 解析报错怎么修？
- [服务状态与实时动态](https://docs.looprouter.com/live/overview.md): LoopRouter 服务运行状态、上游负载与计划内维护公告；遇到异常时的自查与联系方式
- [动态归档](https://docs.looprouter.com/live/archive.md): LoopRouter 历史实时动态归档：功能上线、维护窗口与已解决事件
- [最新公告](https://docs.looprouter.com/news/overview.md): LoopRouter 产品公告：新能力上线、接口更新与计费说明
- [Seedance 2.0 视频生成正式上线](https://docs.looprouter.com/news/seedance-2-0-launch.md): LoopRouter 上线 Doubao Seedance 2.0 视频生成 API：文生 / 图生 / 多模态参考，与火山引擎方舟完全兼容
- [素材库与真人认证 API 上线](https://docs.looprouter.com/news/asset-and-real-person-launch.md): LoopRouter 上线素材库与真人认证接口：角色一致性与真人口播全流程 API 化
- [携带参考视频自动享受输入折扣](https://docs.looprouter.com/news/video-input-discount.md): 请求 content 中包含参考视频（video_url）时，系统自动应用带视频输入的优惠倍率，无需额外传参

## API 规范

- [OpenAPI 规范](https://docs.looprouter.com/openapi.yaml): 视频生成任务接口的完整请求/响应定义