用于生产工作流的图像换脸 API
通过 GoEnhance API 将基于同意的换脸功能添加到图像处理流水线中。提交目标图像和源人脸，存储返回的任务 ID，然后轮询或接收回调，直到结果达到最终状态。
获取 API 访问权限
专注的图像换脸 API 契约
围绕记录的请求、任务和结果契约进行构建。
生产环境中的关键能力
Bearer 认证请求
将 GoEnhance API 密钥保存在您的服务器上，并将其放在 Authorization 请求头中发送。切勿在浏览器代码中暴露生产环境凭据。
明确的目标和源角色
使用 <code>reference_img</code> 进行目标合成，使用 <code>source_img</code> 进行人脸转换，以防止常见的输入顺序错误。
HTTPS 资产验证
在创建任务之前，验证两个图像 URL 是否可被 API 访问，并确保它们保持在记录的 5 MB 限制内。
异步任务 ID
持久化返回的 <code>img_uuid</code>，以便工作进程、重试机制、回调和面向客户的状态检查都能引用同一个作业。
轮询或回调
使用退避策略轮询作业详情端点，或在可公开访问的 HTTPS 端点上接收状态更改回调。
类型化结果处理
通过 <code>type</code> 检查每个结果条目，而不是假设第一项始终是图像 URL，并将即将过期的输出复制到您自己的已批准存储中。
使用当前账户定价和余额数据作为事实来源。
无需猜测的图像换脸 API 定价
查看实时图像换脸 API 定价
当前的公共端点参考未发布固定的每图像代币费率。在预测支出之前，请在 GoEnhance 计费页面确认实时费用，而不是依赖虚构或过时的数字。
监控代币余额
使用 <code>GET /api/v1/user/tokens</code> 从 <code>data.count</code> 读取可用余额，并在提交任务前触发内部警报。
设置应用级预算
记录任务创建和最终结果，按租户限制使用量，并根据您的 GoEnhance 账户定价核对计费活动。
分三步集成 GoEnhance API
1
1. 验证同意书和输入内容
确认您已获得使用两张人脸的许可，验证 HTTPS 访问权限，强制执行文档规定的文件大小限制，并在提交前拒绝不支持或模糊的资产。
2
2. 创建并持久化任务
将两个图像URL POST到
/api/v1/imagefaceswap/generate，检查HTTP和响应级别的成功状态，并存储返回的 img_uuid。 3
3. 解析并存储结果
使用退避策略进行轮询或验证回调交付，根据最终状态和结果类型进行分支处理，并在临时链接过期前将成功输出的内容移至持久存储中。
将同意、披露和访问控制视为产品需求，而非可选的文案。
实用且基于许可的使用场景
经授权的个性化营销活动
为已明确授权使用其图像的艺人、代言人或客户生成经批准的创意变体。
电影与预演
在制作过程中创建内部概念帧或选角预览，同时保留最终审核和版权许可环节。
本地化创意工作流
在保留可追溯的来源权限和人工审核的前提下，为区域性营销活动调整已批准的视觉资产。
头像与个人资料体验
支持用户知情并主动提供目标图像和源人脸的头像实验。
创意原型设计
在委托最终摄影前测试布局和视觉方向，且不将合成输出呈现为真实事件。
受控媒体工具
将换脸功能添加到受控应用程序中，并包含同意检查、滥用报告、保留规则以及生成环节的审核门控。
关于集成、定价、任务处理和负责任使用的实用解答。