Skip to main content
GET
cURL

Authorizations

TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Query Parameters

jobId
string
required

Job ID returned synchronously by the generation endpoint (supports URL parameters/request body)

Response

Request successful

status
enum<string>
required

Task status: ON_QUEUE-processing, SUCCESS-success, FAILED-failed

Available options:
SUCCESS,
ON_QUEUE,
FAILED
Example:

"SUCCESS"

message
string | null
required

Response message: returns success on success, returns specific error reason on failure, returns null during processing

Example:

"success"

jobId
string
required

Unique task identifier for querying task status or receiving callback notifications

Example:

"5ecc5080-b1d7-4b9f-8184-435e46ebb5cb"

data
SUCCESS · object
required

Task data (different fields returned based on status)

Last modified on April 22, 2026