授权 API

对在特定地区和语言发行作品的权利进行定价并提出请求。报价是不具约束力的估算（license:read）；请求会启动由 NU 审核并签署的真实协议（license:write）。

端点

方法	路径	用途
POST	`/licenses/quote`	价格估算及权利检查；不具约束力。
POST	`/licenses/requests`	创建授权请求（协议）。
GET	`/licenses`	列出您的协议，可按状态筛选。
GET	`/licenses/{license_id}`	协议详情。

商业模式

business_model	说明
`MG_RS`	最低保证金加收入分成；MG 从 RS 中回收
`PURE_RS`	无最低保证金的纯收入分成
`FLAT_LICENSE`	按期限收取固定授权费
`API_FEE_RS`	API 或平台费加收入分成
`DATA_LICENSE`	数据或指标授权
`UNDECIDED`	尚未选择；模式达成一致前的默认值

这些模式如何影响结算金额，请参见结算 API。

报价与请求

报价——可安全重复调用；返回估算和 availability。不会形成任何承诺。
请求——提交协议供 NU 审核。它会进入协议生命周期，并可能需要签署合同后才能成为 active。

获取报价

curl -X POST "https://signal-partners.newunivers.ai/v1/licenses/quote" \
  -H "Authorization: Bearer nsp_live_xxx" \
  -H "X-NU-Partner-Id: org_acme" \
  -H "X-NU-Request-Id: req_license_0001" \
  -H "Content-Type: application/json" \
  -d '{
    "title_id": "ttl_abc",
    "territories": ["KR", "JP"],
    "languages": ["ko", "en"],
    "exclusive": false,
    "resale_allowed": false,
    "expected_monthly_views": 200000,
    "business_model": "MG_RS"
  }'

{
  "data": {
    "result": "auto_quote",
    "availability": {
      "available": true,
      "rights_status": "clear",
      "conflicts": []
    },
    "estimated_terms": {
      "business_model": "mg_rs",
      "mg_amount": 25000,
      "revenue_share_rate": 0.35,
      "flat_license_fee": null,
      "api_fee_monthly": null,
      "currency": "USD"
    },
    "next_step": "submit_license_request"
  }
}

创建请求

curl -X POST "https://signal-partners.newunivers.ai/v1/licenses/requests" \
  -H "Authorization: Bearer nsp_live_xxx" \
  -H "X-NU-Partner-Id: org_acme" \
  -H "Content-Type: application/json" \
  -d '{
    "title_id": "ttl_abc",
    "territories": ["KR"],
    "languages": ["ko"],
    "exclusive": false,
    "business_model": "MG_RS",
    "expected_monthly_views": 200000,
    "message": "Launch on Acme OTT, KR only."
  }'

{
  "data": {
    "license_deal_id": "lic_123",
    "status": "requested",
    "next_step": "nu_internal_review"
  }
}

成功请求返回 HTTP 200。该端点通过可选 X-NU-Request-Id 实现幂等：已完成的重试返回原始响应，仍在处理的并发重复请求返回 409 conflict。

协议状态生命周期

requested → reviewing → quoted → negotiating → approved → contracting → signed → active → expired
                    ↘ rejected                                                            ↘ cancelled

只有具有 production_api_enabled: true 的 active 协议才能授权其作品、地区和剧集集的 Production 播放。

列出与筛选

curl "https://signal-partners.newunivers.ai/v1/licenses?status=active" \
  -H "Authorization: Bearer nsp_live_xxx" -H "X-NU-Partner-Id: org_acme"

返回协议 data[]，不含 pagination 封装。列表和单个协议响应均包含 updated_at。

保持同步（轮询）

不提供 Webhook。要检测 quoted 或 active 等状态变化，请使用 updated_since 轮询此端点。发送目前所见最大的 updated_at，即可按升序仅接收后续变更并推进水位。

curl "https://signal-partners.newunivers.ai/v1/licenses?updated_since=2026-06-24T10:00:00Z" \
  -H "Authorization: Bearer nsp_live_xxx" -H "X-NU-Partner-Id: org_acme"

若后续播放返回 license_not_active，请在此检查协议的 status 和 production_api_enabled。