AI 媒体集成通常从一个功能开始，却会很快扩展：客服体验需要实时数字人，全球营销需要翻译视频，而个性化创意可能需要转换面孔或角色——但前提是获得当事人的授权。
AKOOL 将这些能力整合在同一套 API 中。其优势并非所有请求都调用同一端点，而是团队能在一个平台、一套身份验证机制和一套生产治理方案下管理多种媒体工作流。
简要答案：当应用需要实时 Streaming Avatar、异步 Video Translation，或经授权的 Face Swap 与 Character Swap 工作流时，可使用 AKOOL OpenAPI。先按目标选择端点系列，再为生成内容配置同意、访问控制、审核、存储和删除规则。
从目标出发，而不是从模型出发
这三类需求对应不同的生产模式。
- 实时数字人： 使用 Streaming Avatar API 和 SDK 建立实时会话，并检查回答质量、轮次衔接、延迟和人工转接。
- 本地化的已批准视频： 将 Video Translation API 作为异步媒体任务使用，并检查翻译、声音、字幕、口型同步和时间轴。
- 获准的面孔或角色转换： 使用 Face Swap、Character Swap 或相关身份工具作为异步任务，并审核授权、形象准确性、使用语境和披露要求。
这种区分很重要。流式会话具有创建、加入、交互、打断和关闭的生命周期；媒体生成任务则需要提交、监控、审核、下载，并最终批准或拒绝。把两者都视为普通的“生成”调用，会导致错误处理薄弱，也会让用户不清楚接下来会发生什么。
1. 使用 Streaming Avatar 构建实时数字人
Streaming Avatar API 用于管理数字人与实时会话。后端以 avatar_id、voice_id、语言、交互模式和可选知识源创建会话，浏览器或应用再通过 AKOOL SDK 加入返回的实时频道。
当数字人需要对话时，使用 dialogue 模式。如果回答必须依据已批准的文档或网址，在创建会话时加入 knowledge_id。应用还应提供打断操作，并在对话结束后关闭会话。
适用场景包括产品导购、入门引导、培训、礼宾服务和一线支持。数字人不应超出已批准资料，擅自生成政策、价格、安全说明或受监管建议。
会话的关键职责
- 在后端创建会话，避免凭据进入浏览器。
- 仅向客户端发送临时加入参数。
- 明确数字人可以回答什么、何时必须转人工。
- 测试麦克风与文本输入、打断、重连和会话关闭。
- 持续确认连接的知识源仍然有效。
Create Session 参考文档 是当前字段和流服务选项的权威来源。
2. 使用 Video Translation 制作本地化媒体
Video Translation API 接收已批准的源视频，并通过异步任务生成本地化版本。它支持源语言检测、多目标语言、可选口型同步、字幕处理、去除背景音乐、声音选择、术语控制和动态时长。
集成流程如下：
- 读取当前支持的语言列表。
- 使用稳定的源视频 URL 提交翻译任务。
- 保存返回的任务 ID。
- 轮询结果端点或使用 webhook。
- 将完成的输出下载到自己的合规存储中。
- 发布前审核每一种目标语言。
任务显示完成并不等于编辑审核通过。产品名称、数字、单位、法律声明、字幕、声音身份、嘴部动作和画面操作仍需检查。AKOOL 提醒 API 生成资源具有临时性，因此生产系统应把批准后的文件复制到持久存储，不要长期依赖结果 URL。
3. 身份转换必须以授权为前提
“授权身份转换”是一类治理要求，并非单一 API 名称。AKOOL 会根据创意需求提供 Face Swap、Character Swap、Head Swap 等工具。
Face Swap Plus 是面向图片和视频的统一换脸 API，可支持多张面孔。Character Swap 则把所提供角色图片的外观映射到源视频动作上。应根据需要保持稳定的对象——面孔、完整角色、表演还是场景——来选择工具。
技术能力只是工作流的一部分。AKOOL 的 Trust & Safety 框架 强调同意、用户控制、人工监督和内容审核。应把这些原则纳入产品，而不是把授权变成发布前的最后一个勾选框。
最低授权流程
- 确认上传者拥有素材，或持有可核实的使用许可。
- 记录允许的用途、渠道、市场和有效期。
- 防止公共客户端暴露 API 凭据。
- 审核输入素材与预期使用语境。
- 对外发布前必须人工审核。
- 保留政策要求的披露或来源信息。
- 支持撤回授权、删除和事件升级。
不得利用身份工具冒充他人、规避验证、制作欺骗性背书，或在授权范围外转换他人形象。
共用的生产架构
端点系列虽然不同，外围架构可以保持一致。
- 客户端应用： 收集输入、说明处理方式、显示进度并呈现已批准结果。
- 自有后端： 验证请求、执行授权规则、创建会话或任务并保护 API 密钥。
- AKOOL API： 运行所选的数字人、翻译或转换工作流。
- 任务/会话存储： 记录 ID、所有者、状态、授权范围和到期时间。
- 审核队列： 检查质量、政策、本地化和品牌要求。
- 持久存储： 仅在所需期限内保存获批输出。
AKOOL 当前建议直接使用 x-api-key。请把密钥保存在服务端环境变量或托管密钥库中，绝不要放入浏览器代码、移动端安装包、公共代码库或可下载示例。实施前请查看最新的身份验证指南。
上线前检查清单
☐ 每条用户路径都对应正确的端点系列。
☐ API 密钥始终保留在后端。
☐ 应用能够区分实时会话与异步任务。
☐ webhook 或轮询覆盖排队、处理、成功与失败状态。
☐ 已批准输出会从临时结果 URL 复制到受控存储。
☐ 涉及身份的媒体有书面授权和撤回路径。
☐ 翻译与转换结果均通过人工质量审核。
☐ 实时数字人具备范围限制、升级路径、打断和会话关闭机制。
统一 AI 媒体 API 的价值
客户体验平台可以把基于知识库的 Streaming Avatar 与多语言入门视频结合；全球营销系统可以本地化已批准的营销活动，并创建获准的区域版本；培训产品可以把互动讲解员与多语言课程媒体结合；创意平台则能在账户层执行授权和审核的同时提供转换功能。
价值来自共用的编排体系，而不是把所有工作流压缩成一个按钮。
结论
AKOOL 通过专门的 API 支持这三类能力：Streaming Avatar 用于实时互动，Video Translation 用于多语言媒体，Face Swap 或 Character Swap 用于经授权的身份转换。真正可用于生产的集成，还必须在这些 API 周围加入安全的后端认证、明确许可、状态处理、人工审核、持久存储和删除控制。
准备评估工作流时，请阅读 AKOOL API 文档，先构建一个范围明确、可完整审核的用例，再逐步组合多项能力。
常见问题
AKOOL 是否用一个端点处理所有媒体任务？
不是。AKOOL 提供一套 API，但包含多个端点系列。Streaming Avatar 采用实时会话管理；翻译与转换工具通常创建异步任务，需要持续监控和审核。
浏览器可以直接调用 AKOOL 吗？
生产应用应通过自有后端发起经过身份验证的调用。这样既能保护 API 密钥，也能集中执行权限、限流、日志和授权规则。
对话式数字人应该使用哪个 API？
使用 Streaming Avatar。如果对话应依据公司文档或网址，请先创建 AKOOL Knowledge Base，并在后端创建会话时传入其 knowledge_id。
Face Swap 成功是否意味着素材可以直接发布？
不是。生成成功只代表任务完成。发布前仍要检查授权、使用语境、形象与视觉质量，并加入政策或市场要求的披露信息。
资源
