跳转到主要内容
POST
/
api
/
open-api
/
v1
/
seedance
/
sp
/
realperson
/
submit
SP Submit Real-Person Whitelist
curl --request POST \
  --url https://www.jimmyai.cn/api/open-api/v1/seedance/sp/realperson/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "url": "<string>"
}
'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "asset_id": "<string>",
    "official_id": "<string>",
    "status": "<string>",
    "asset_ref": "<string>",
    "name": "<string>",
    "url": "<string>",
    "created_at": "<string>"
  }
}
提交真人图片素材进行加白处理。处理完成后可用于 SP 经济版视频生成中的真人参考。

​
流程

  1. 调用本接口提交真人图片 URL
  2. 使用返回的 asset_id 轮询 查询真人加白状态
  3. 状态变为 Active 后，使用 asset_ref 或 asset://{asset_id} 在 SP 创建视频 中引用

​
请求参数

字段类型必填说明
namestring是真人素材名称
urlstring是真人图片公网 URL

​
请求示例

curl -X POST 'https://www.jimmyai.cn/api/open-api/v1/seedance/sp/realperson/submit' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "模特正面照",
    "url": "https://example.com/portrait.jpg"
  }'

​
响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "asset_id": "official_id_xxx",
    "status": "Processing",
    "asset_ref": null,
    "name": "模特正面照",
    "url": "https://example.com/portrait.jpg"
  }
}
提交成功后 status 通常为 Processing，asset_ref 在处理完成前为 null。

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
​
name
string
必填

Real-person asset name

​
url
string
必填

Public portrait image URL

响应

200 - application/json

Submitted successfully

​
code
integer
示例:

0

​
msg
string
示例:

"ok"

​
data
object