Create character
POST
/sora/v1/characters
- Create reusable characters from a video segment
- Provide either
urlorfrom_taskas the source - Use
timestampsin seconds to mark appearance time (recommended 1-3 seconds)
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
url
string
Video URL containing the character to create (choose either this or from_task).
timestamps
string
Required
Time range in seconds, for example 1,2 means second 1-2; range delta must be 1-3 seconds.
from_task
string
Use an existing generated task id to create a character.
Responses
application/json
object
id
string
Required
Character id.
username
string
Required
Character name, usable in prompts as @{username}.
permalink
string
Required
Character homepage URL (opens OpenAI character page).
profile_picture_url
string
Required
Character avatar URL.