Create video (with Character)

POST

/v1/video/create

• Create videos based on the sora series models using the unified standard API format
• Generate short videos from prompts with optional reference images
• Control quality and aspect ratio with the size and orientation fields
• Use character_url and character_timestamps to create reusable characters

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Optional list of reference image URLs

Sora series model to use

Video orientation, portrait for vertical and landscape for horizontal

Valid values"portrait""landscape"

Natural language prompt describing the target video

Duration in seconds

Valid values101525

Video URL used to create the character; must not contain real people

Time range in seconds where the character appears, in the format {start},{end}, with end-start between 1 and 3 seconds

Video quality, large for HD and small for standard

Valid values"large""small"

Responses

Task created successfully

Content-Type

application/json

object

Task ID

Task status

Status update time in milliseconds

Format"int64"