Authorization: Bearer（应用私有API Key）；POST使用Content-Type: application/json。网页登录Cookie不能代替应用Key。

请求参数

JSON必填：useId(UUID)、title(非空最多200字符)、mimeType(image/png、image/jpeg、video/mp4)、dataBase64(实际文件标准Base64，解码最多5MiB)、idempotencyKey。文件类型匹配Use用途，训练Use不能回传内容。

返回结果

data为Content，关联Use/License/Order/Face/App；包含sha256、byteCount、status=UNDER_REVIEW、automaticReview=NOT_CONFIGURED。一个Use一份内容，回传不再扣次数。新账本 use 在可信 AI 标识模块接入前返回 AI_LABEL_REQUIRED。

UNDER_REVIEW仅表示首次创建状态；幂等重放可能返回当前已批准或已驳回状态，不重新发起审核。

成功：{data, requestId}；失败：{code, message, requestId, details?}。HTTP失败不要当作业务成功。

错误处理

401 UNAUTHENTICATED；404 NOT_FOUND；409：状态或幂等冲突；422 INVALID_INPUT。仅检查基本文件标识，不是恶意扫描。服务内部错误返回安全错误，不显示数据库诊断。记录requestId用于排查。

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

即将上线：AI 生成能力

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

1. 获取已许可使用凭据

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

POST /api/developer/license-uses

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

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

2. 回传实际内容文件

/api/developer/contents

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投递当作这些能力已完成。

API 文档

内容回传