Skip to main content
POST
cURL

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 [blocked] is consistent with fetch structure. If not set, you need to request the fetch interface [blocked] for query

Response

Request successful

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

data
object
required
Example:
Last modified on May 5, 2026