真人 H5 认证

创建真人活体认证会话，返回 byted_token 与 h5_url。须引导用户在手机打开 H5 完成认证；真人认证不可跳过。认证成功后调用 byted_token 换组获取 group_id，再上传同人素材。

使用 jade-test-seedance-2.0 时必须传 provider=jade，否则会进生产素材库，无法给测试模型引用。详见测试通道指南。

POST/v1/assets/real-person/sessions已上线

鉴权

所有 /v1/* 接口均必须携带平台 API Key：Authorization: Bearer sk-pyo-...。Key 在控制台 → API Keys 创建。上游移动云等供应商 Key 由平台托管，客户无需直接使用。

# 生产 chinamobile-seedance-2.0
curl -X POST "https://www.openmodels.com.cn/v1/assets/real-person/sessions" \
  -H "Authorization: Bearer <OPENMODELS_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://your-app.example/hooks/asset-auth"
  }'

# 测试 jade-test-seedance-2.0（必传 provider；jade 不支持 callback_url）
curl -X POST "https://www.openmodels.com.cn/v1/assets/real-person/sessions" \
  -H "Authorization: Bearer <OPENMODELS_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{ "provider": "jade" }'

字段	说明
provider	可选。jade-test-seedance-2.0 必须传 jade；默认走生产素材库
callback_url	可选。仅生产/移动云通道；jade 通道不支持此字段，请勿传

{
  "object": "asset.real_person.session",
  "byted_token": "xxxxxxxx",
  "h5_url": "https://...",
  "callback_url": "https://..."
}

光线、角度可能导致认证失败，可引导用户重试
补充素材会做人脸一致性校验；建议清晰正面图，视频避免侧脸/多人
一个平台账号可对应多个真人组（受上游账号策略约束）

Action 等价： POST /v1/assets?Action=CreateVisualValidateSession&Version=2024-01-01。