Face-swap / Live
唯一正式上线的产品能力：face-swap API
这个页面只回答三个问题：适合谁用、怎么接、限制是什么。它不会再和首页重复讲抽象叙事。
Scenario 01
创作者工具
适合把换脸能力嵌进创作者产品，而不是让用户直接接触内部任务系统。
Scenario 02
素材处理链路
source 和 target 独立上传，便于校验、重试和后续审计。
Scenario 03
产品验证阶段
先用单一 face-swap 能力验证产品路径，再考虑更大的模型目录。
Product overview
当前可以直接验证的内容
async workflow
异步 job
先创建任务，再上传素材、运行任务、轮询状态和获取结果。
API Key 鉴权
公开接口 `/v1/*` 仍然统一走 Bearer API Key。
TTL 结果下载
素材和结果都是时效资源，适合验证型接入与短周期下载。
Input & output
输入输出边界
- • source 与 target 分开上传。
- • 当前只支持 JPEG / PNG，单文件限制 5MB。
- • 任务成功后返回可下载结果地址。
Integration flow
接入流程
- 1. 先用 model_key 和参数创建 job。
- 2. 分别上传 source 与 target 素材。
- 3. 运行任务并查询状态。
- 4. 读取结果地址并下载输出。
Boundary
失败边界与计费点
- • 计费发生在任务成功运行后，不发生在素材上传时。
- • 余额不足会阻断 run 步骤。
- • 素材过期或任务未完成都无法生成可下载结果。
API skeleton
核心接口
POST /v1/jobs
POST /v1/jobs/{job_id}/assets
POST /v1/jobs/{job_id}/run
GET /v1/jobs/{job_id}
GET /v1/jobs/{job_id}/result