面向生产流程的视频换脸 API
通过 GoEnhance API 为你的视频流程加入需授权的换脸能力。提交目标视频、源人脸图片、输出设置和一个时间片段；随后保存返回的任务 ID，再去获取异步结果。
获取 API 权限
职责清晰的视频换脸 API 契约
围绕文档里的请求、任务与结果契约来构建。
生产环境里真正要紧的能力
Bearer 鉴权的请求
把 GoEnhance API Key 保存在你自己的服务器上，通过 Authorization 请求头发送。切勿在浏览器代码里暴露生产环境凭据。
明确的素材角色
<code>reference_video</code> 用于目标片段，<code>reference_img</code> 用于要迁移过去的人脸，避免常见的传参顺序搞反的问题。
有明确上限的源素材
提交前先确认素材可以正常访问。现行端点文档记载的上限是视频 200 MB、图片 5 MB。
带时间范围的转换片段
<code>start_time</code> 和 <code>end_time</code> 的取值范围是 0 到 120 秒，并且要校验所选区间对源片段而言确实有效。
输出与增强参数
<code>upscaler</code> 选 1 输出 720p，选 2 输出仅限 VIP 的 1080p；只有流程确有需要时才开启 <code>enhance_face</code>。
带类型的异步结果
保存 <code>img_uuid</code>，处理好所有终态，按 <code>type</code> 区分结果条目，并在临时链接过期前把成功的产物转存下来。
以实时计费页面和账户余额为准。
不靠猜的视频换脸 API 价格
查询实时的视频换脸 API 价格
端点文档只给出了费用倍率，没有给出固定的基础单价。做成本预估之前，请先在 GoEnhance 计费页面确认当前的基础扣费。
把可选项的倍率算进去
现行文档把 1080p 输出和人脸增强标记为 1.5x 价格的选项，但没有说明多个选项叠加时如何计算，所以不要凭猜测，要以实际扣费为准。
监控点数与预算
用 <code>GET /api/v1/user/tokens</code> 读取 <code>data.count</code>，再围绕你当前的 GoEnhance API 价格加上按租户的额度限制、任务流水记录和告警。
三步接入 GoEnhance API
1
1. 校验授权与素材
确认已取得当事人同意与使用权，核实两个 URL 都能访问，按文档执行体积与时长上限，并在提交前拒绝不受支持或含糊不清的输入。
2
2. 创建并保存任务
把必填的素材、时间范围和输出设置 POST 到
/api/v1/videofaceswap/generate；先检查 HTTP 状态和响应体里的成功标志，再保存 data.img_uuid。 3
3. 跟踪、验收并存档产物
带退避地轮询，或校验回调是否送达；按终态和结果类型分支处理；检查换脸结果在人物一致性和帧间连贯性上是否达标，再把通过审核的产物转入持久化存储。
把同意授权、信息披露和访问控制当成产品需求，而不是可有可无的说明文案。
有实用价值、且以授权为前提的场景
已获授权的营销素材变体
为已明确授权使用其肖像的艺人、品牌大使或客户制作经过批准的视频变体。
影视预演
在正式制作前先试选角或验证场景连贯性，同时在流程中保留人工审核与权利许可环节。
本地化创意制作
把已批准的素材改制成各地区的营销版本，同时保留可追溯的素材授权、披露说明和审核记录。
用户主动选择的娱乐工具
支撑那些由用户自行提供目标片段和源人像、并清楚知道结果是合成内容的体验。
受控的内部原型
用来评估构图和创意方向，但不得把生成的画面当作真实事件或真人代言来呈现。
带审核机制的媒体应用
把换脸能力与访问控制、滥用举报、留存期限、来源溯源记录和审批卡点结合起来。
关于接入、价格、任务处理与负责任使用的实用解答。