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
prompt
string
required

Free-form prompt describing the video.

mode
string
default:t2v
required

Allowed value: "t2v"

aspect_ratio
enum<string>
default:auto

Output aspect ratio. auto lets the harness choose from the prompt and any references.

Available options:
auto,
21:9,
2:1,
16:9,
4:3,
1:1,
3:4,
9:16
duration
default:auto

Video duration in seconds (any whole second from 5 to 20), or auto to fit the content.

Required range: 5 <= x <= 20
resolution
enum<string>
default:hd

Video resolution class: hd, or fhd for a higher-resolution result finished by the video upsampler. Exact dimensions vary with the aspect ratio.

Available options:
hd,
fhd
version
enum<string>

Endpoint version. latest serves the current release.

Available options:
latest
Example:

"latest"

generate_audio
boolean
default:true

Generate synchronized audio alongside the video.

safety_tolerance
integer
default:2

Tolerance level for input and output harm moderation. Between 0 and 4, with 0 the strictest. Sexual content is limited to level 3 and hate content to level 2 regardless of the requested tolerance. Contextual safety signals can tighten the requested level.

Required range: 0 <= x <= 4
draft
boolean
default:false

Draft mode: generate a fast preview and return a draft_cache download URL in the result. Download that bundle and pass it back later to render the full-quality version of the same generation.

webhook_url
string

TTAPI asynchronous callback URL. The initial response returns jobId; use this callback or the Flux fetch endpoint to receive the final video result.

Response

Request successful

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

data
object
required
Example:
Last modified on August 8, 2026