PERSONACLEAR / API

授权校验、同意检查与报价

面向品牌、广告代理、制片和 AI 平台的轻量接口说明。当前为 TEST 环境,真实项目需合同与人工审核。

1. 校验 License

公开接口,不需要登录。返回签名、状态、policy hash、场景/地域/期限/训练/转授权校验结果。

GET /api/licenses/{licenseId}
GET /api/licenses/{licenseId}?scene=short_drama&scopes=face&output=video
GET /api/licenses/{licenseId}?scopes=voice
GET /api/licenses/{licenseId}?model_training=1
参数说明
sceneshort_drama / brand_tvc
territory默认 CN;GLOBAL 表示全球
scopesface,voice,name,full_ai_twin,逗号分隔
outputstills / video / poster
purpose用于命中禁止用途
model_training1 / true
sublicense1 / true

通过返回 200 + valid: true;拒绝返回 409,reason 例如:

scene_not_allowed
scope_not_allowed
model_training_not_allowed
territory_not_allowed
license_expired
consent_inactive
policy_hash_mismatch

2. 检查同意

需要管理员令牌或本人 token;用于签约前确认“这个人是否同意这个用途”。

POST /api/consent/check
Content-Type: application/json

{
  "personNo": "PT-P-0004",
  "scopes": ["face"],
  "scene": "short_drama",
  "territory": "CN",
  "output": "video",
  "modelTraining": false,
  "sublicense": false
}

返回 allowed、reasons、scopes、policy、ledger.valid/head。

3. 报价

公开接口。参考报价,不是合同要约。

POST /api/quote
Content-Type: application/json

{
  "scopes": ["face","voice"],
  "scene": "brand_tvc",
  "output": "video",
  "termMonths": 18,
  "territory": "CN",
  "exclusivity": "category",
  "modelTraining": false,
  "rush": false
}

返回逐项金额与总额。基础 1,200;品牌 TVC +300;声音 +400;姓名 +300;完整 AI 分身 +1,000;视频 +300;超 12 个月按 6 个月阶梯;全球 +30%;类目排他 +600;训练 +1,000;加急 +20%。

4. 同意台账

GET /api/people/{personNo}/consent-ledger

需要本人 token 或管理员令牌。返回哈希链事件、合同接受记录、valid/head。

5. 审计链

GET /api/admin/p0/audit

需要管理员令牌。返回 valid、head、total、最近事件。

6. API Key

企业客户可申请 API Key;当前用于同意检查,后续开放 License 批量校验与报价。

X-API-Key: pc_xxxxxxxxxxxxxxxxx

POST /api/consent/check
Header: X-API-Key

Key 由管理台生成,只显示一次;scope 示例:consent:check。撤销后立即失效;支持 expiresAt 过期与 120 次/分钟 限流。

GET  /api/admin/p0/api-keys
POST /api/admin/p0/api-keys
POST /api/admin/p0/api-keys/{id}/revoke

7. 品牌合同

GET  /api/brand-contracts/{token}
POST /api/brand-contracts/{token}/sign
GET  /api/brand-contracts/{id}/verify
GET  /api/brand-contracts/{id}/pdf?token=...

在线签署后生成 PDF,合同哈希与平台签名写入 PDF 尾页;verify 返回哈希/签名是否一致。

8. Provenance / C2PA-ready

GET  /api/assets/{assetId}/provenance
GET  /api/assets/{assetId}/verify
POST /api/admin/p0/assets/{assetId}/c2pa-ready

返回 manifest/provenance、可见水印记录、C2PA-ready key。C2PA-ready 是 Ed25519 签名 JSON,不是正式 C2PA。

9. OpenAPI

GET /openapi.json

机器可读接口清单;后续 SDK 直接按此生成。

10. 保险登记

GET /api/insurance

公开摘要:保险公司、险种、限额、期间;不返回保单号/凭证敏感信息。没有记录表示“待投保”。

边界:所有 TEST 证书/资产不可对外商用;真实项目仍需合同、IDV、授权范围和人工审核。接口不返回原始人脸素材,也不接受“训练授权”的口头承诺。

← 返回 PersonaClear