Перейти к основному содержанию
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"
  }
}

Авторизации

​
TT-API-KEY
string
header
обязательно

Вы можете получить API-ключ в TTAPI Dashboard.

Тело

application/json
​
timestamps
string
обязательно

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
обязательно

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

Ответ

Запрос выполнен успешно

​
status
string
обязательно
Пример:

"SUCCESS"

​
message
string
обязательно
Пример:

"success"

​
data
object
обязательно
Пример:
{ "job_id": "job_id" }
Last modified on March 26, 2026