Skip to main content
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>"
  }
}
Submit a real-person portrait for whitelist processing. Once active, the asset can be used in SP economy video generation.

​
Flow

  1. Call this endpoint with a portrait URL
  2. Poll Query Real-Person Status using the returned asset_id
  3. When status is Active, use asset_ref or asset://{asset_id} in SP Create Video

​
Request body

FieldTypeRequiredDescription
namestringYesAsset name
urlstringYesPublic portrait image URL

​
Example

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": "portrait-front",
    "url": "https://example.com/portrait.jpg"
  }'

​
Response

{
  "code": 0,
  "msg": "ok",
  "data": {
    "asset_id": "official_id_xxx",
    "status": "Processing",
    "asset_ref": null,
    "name": "portrait-front",
    "url": "https://example.com/portrait.jpg"
  }
}
After submission, status is usually Processing and asset_ref is null until processing completes.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
name
string
required

Real-person asset name

​
url
string
required

Public portrait image URL

Response

200 - application/json

Submitted successfully

​
code
integer
Example:

0

​
msg
string
Example:

"ok"

​
data
object