Skip to main content
POST
Sora 2 Character

Authorizations

Authorization
string
header
required

All APIs require Bearer Token authentication

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json
model
string
default:sora-2-character
required

sora-2-character: Character ID extraction, free

Example:

"sora-2-character"

video_url
string
required

Video URL containing the character

Notes:

  • Must be an MP4 video URL
  • Input video minimum 720p
  • Maximum aspect ratio approximately 2.67:1
  • Videos exceeding 1080p will be automatically scaled down
  • Videos longer than 4 seconds will only use the first 4 seconds
Example:

"https://example.com/character-clip.mp4"

name
string
required

Character name

Notes:

  • Length 1 - 80 characters
  • Use this name to reference the character in subsequent prompts
Maximum string length: 80
Example:

"Alice"

Response

Task created successfully

created
integer

Task creation timestamp

Example:

1757165031

id
string

Task ID

Example:

"task-unified-1757165031-uyujaw3d"

model
string

Actual model name used

object
enum<string>

Specific task type

Available options:
video.generation.task
progress
integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100
Example:

0

status
enum<string>

Task status

Available options:
pending,
processing,
completed,
failed
Example:

"pending"

task_info
object

Async task information

type
enum<string>

Task output type

Available options:
video
Example:

"video"