Skip to main content
POST
/
sora
/
role
/
create
create role task
curl --request POST \
  --url https://api.mountsea.ai/sora/role/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "videoUrl": "https://example.com/example.mp4",
  "name": "mikeniuniu",
  "displayName": "display name of the role",
  "description": "description of the role",
  "instructionText": "instruction text of the role",
  "safetyInstructionText": "safety instruction text of the role"
}
'
{
  "taskId": "<string>"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
videoUrl
string<uri>
required

video url of the role,not longer than 3 seconds

Example:

"https://example.com/example.mp4"

​
name
string
required

name of the role，must be unique

Example:

"mikeniuniu"

​
displayName
string

display name of the role

Example:

"display name of the role"

​
description
string

description of the role

Example:

"description of the role"

​
instructionText
string

instruction text of the role

Example:

"instruction text of the role"

​
safetyInstructionText
string

safety instruction text of the role

Example:

"safety instruction text of the role"

Response

Role task created successfully

​
taskId
string
required

task id, used to get task result later