许可使用、内容回传与通知接入

生成提供方未配置

旧生成接口和模拟进度示例已撤下。本页只说明当前可执行的许可使用与实际内容回传，不承诺已生成图片/视频，也不承诺现实商用肖像权。

1. 获取已许可使用凭据

先完成授权包竞拍、沙箱付款并取得有效License。使用该许可所属Application的API Key，在您的服务端调用：

输入licenseId、purpose、channel、territory、training、idempotencyKey。训练权限独立判断；成功受理消耗一次许可额度，同参数同幂等键重试不重复消耗。返回Use ID不是生成任务ID，当前平台不代调用模型。

真实客户端与完整接入说明 · 查看许可与额度

2. 回传实际内容文件

POST，Bearer API Key；输入useId、title、mimeType、dataBase64、idempotencyKey。支持PNG/JPEG/MP4，最多5MiB；同Use只保存一份内容，不再次扣次数。字段及关联由后端校验，不支持旧file_url/order_id示例替代真实文件。

下载 JavaScript 客户端 · 下载实际文件回传示例

两个文件放同一目录，Node.js 22及以上。私下配置下列进程环境变量，再运行 node return-content.mjs。脚本会将指定文件上传至配置的服务，不会创建Use或调用生成模型。

• FACEPIC_API_KEY：当前Application私有密钥，不能放进浏览器、Git、URL或日志。
• FACEPIC_BASE_URL：本地默认http://127.0.0.1:3110；其它地址必须HTTPS且需单独授权。
• FACEPIC_USE_ID：已存在的使用凭据编号。
• FACEPIC_CONTENT_FILE：您确认允许上传的本地文件路径。
• FACEPIC_CONTENT_MIME：image/png、image/jpeg或video/mp4。
• FACEPIC_CONTENT_TITLE：作品标题。
• FACEPIC_CONTENT_IDEMPOTENCY_KEY：预先保存的稳定请求标识，重试同一文件和参数时沿用；不能每次随机生成。

输出仅contentId、useId、status、requestId；失败只输出安全错误元数据。UNDER_REVIEW表示等待人工审核，不是已批准或已发布。自动审核NOT_CONFIGURED，文件基本标识检查不是恶意文件扫描。

查看真实内容记录 · 查看使用凭据工作区

3. 接收本地 Webhook

在控制台为Application创建订阅，使用稳定idempotencyKey；只允许服务器预先配置的本地目标，默认无允许目标。已有历史事件不自动重放；许可到期事件若在订阅之后才首次补录，可能投递到当前端点，其实际到期时间可能早于订阅。生产外网目标未开放。

校验X-FacePick-Timestamp与X-FacePick-Signature：HMAC-SHA256(secret, timestamp + '.' + 原始正文)，允许时钟偏差±300秒；再核对正文id与X-FacePick-Event-Id一致，并在自己的数据库事务中按事件ID去重。密钥不写日志。

下载 Webhook 验签工具 · 查看订阅与真实投递记录

至少一次投递，不保证顺序；按事件标识和当前业务状态处理重复/乱序。最多5次尝试、HTTP超时3秒，重试间隔1/2/4/8秒。2xx仅表示接收方接受，不证明下游已完成。许可到期或暂停不会篡改既有内容历史。

尚未完成

真实模型生成任务、生产支付/KYC/自动审核、收益分账与结算仍未接通。不要把许可使用受理、文件回传或Webhook投递当作这些能力已完成。