Skip to content

Create character

POST
/sora/v1/characters
  • Create reusable characters from a video segment
  • Provide either url or from_task as the source
  • Use timestamps in seconds to mark appearance time (recommended 1-3 seconds)

Authorizations

bearer
Type
HTTP (bearer)

Request Body

application/json
object

Video URL containing the character to create (choose either this or from_task).

Time range in seconds, for example 1,2 means second 1-2; range delta must be 1-3 seconds.

Use an existing generated task id to create a character.

Responses

application/json
object

Character id.

Character name, usable in prompts as @{username}.

Character homepage URL (opens OpenAI character page).

Character avatar URL.

Playground

Authorization
Body

Samples