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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
TT-API-KEY
string
header
required

请前往 TTAPI 控制台 获取 API 密钥。

Body

application/json
​
timestamps
string
required

单位秒，例如 ‘1,2’ 是指视频的1～2秒中出现的角色，注意范围差值最大 3 秒最小 1 秒

​
url
string
required

视频中包含需要创建的角色

​
hookUrl
string

回调通知地址，任务完成或失败将通过请地址进行通知，通知数据结构 [blocked]与fetch结构一致。如果未设置，则需要请求fetch接口 [blocked]进行查询

Response

请求成功

​
status
string
required
Example:

"SUCCESS"

​
message
string
required
Example:

"success"

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