Skip to main content
POST
/
sora
/
characters
cURL
curl --request POST \
  --url https://api.ttapi.io/sora/characters \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "timestamps": "<string>",
  "url": "<string>",
  "hookUrl": "<string>"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "job_id"
  }
}

Authorizations

​
TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
​
timestamps
string
required

Time in seconds. For example, ‘1,2’ means the character appears in seconds 1-2 of the video. Note: The range difference must be maximum 3 seconds and minimum 1 second

​
url
string
required

Video URL containing the character to be created

​
hookUrl
string

Callback notification URL. When task completes or fails, this URL will be notified. Notification data structure is consistent with fetch structure. If not set, you need to request the fetch interface for query

Response

Request successful

​
status
string
required
Example:

"SUCCESS"

​
message
string
required
Example:

"success"

​
data
object
required
Example:
{ "job_id": "job_id" }
Last modified on March 13, 2026