面向品牌、广告代理、制片和 AI 平台的轻量接口说明。当前为 TEST 环境,真实项目需合同与人工审核。
公开接口,不需要登录。返回签名、状态、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
| 参数 | 说明 |
|---|---|
scene | short_drama / brand_tvc |
territory | 默认 CN;GLOBAL 表示全球 |
scopes | face,voice,name,full_ai_twin,逗号分隔 |
output | stills / video / poster |
purpose | 用于命中禁止用途 |
model_training | 1 / true |
sublicense | 1 / 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
需要管理员令牌或本人 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。
公开接口。参考报价,不是合同要约。
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%。
GET /api/people/{personNo}/consent-ledger
需要本人 token 或管理员令牌。返回哈希链事件、合同接受记录、valid/head。
GET /api/admin/p0/audit
需要管理员令牌。返回 valid、head、total、最近事件。
企业客户可申请 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
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 返回哈希/签名是否一致。
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。
GET /openapi.json
机器可读接口清单;后续 SDK 直接按此生成。
GET /api/insurance
公开摘要:保险公司、险种、限额、期间;不返回保单号/凭证敏感信息。没有记录表示“待投保”。