Skip to main content
POST
/
sora-partner
/
generations
cURL
curl --request POST \
  --url https://api.ttapi.io/sora-partner/generations \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "prompt": "<string>",
  "input_reference": "<string>",
  "model": "sora-2",
  "seconds": "4",
  "size": "720x1280"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "job_id"
  }
}
合作商渠道prompt中不支持角色使用

Authorizations

​
TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
​
prompt
string
required

Video description. Maximum 32000 characters, minimum 1 character

​
input_reference
string

Optional image reference for guiding generation
Note: The uploaded image dimensions must match the size parameter. If size is not set, the uploaded image dimensions must be 720x1280

​
model
enum<string>
default:sora-2

Video generation model

Available options:
sora-2,
sora-2-pro
​
seconds
enum<integer>
default:4

Video duration

Available options:
4,
8,
12
​
size
enum<string>
default:720x1280

Video size

Available options:
720x1280,
1280x720,
1024x1792,
1792x1024

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