TTAPI Quick Start | AI API Integration Guide (Image, Video, Audio, LLM APIs)

1. Get your API key

Before you call any API, you need a TT-API-KEY.

Step 1: Create your account

Default API key and trial credit

After your account is created, TTAPI generates a default TT-API-KEY. This key is used across all TTAPI endpoints.New accounts also receive 30 quota (about $0.30) in trial credit.

Step 2: Basic account setup

Reset your TT-API-KEY

For security, we recommend rotating the default key before production use. You can reset it directly from the dashboard homepage.

2. Add the request header

All requests must include your API key in the header:

TT-API-KEY: YOUR_API_KEY

3. Send your first request

Step 1: Submit a generation request

The example below creates a Midjourney image task.

curl --request POST \
  --url https://api.ttapi.io/midjourney/v1/imagine \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: YOUR_API_KEY' \
  --data '
{
  "prompt": "A cute kitten",
  "mode": "fast",
  "hookUrl": "<string>"
}
'

import requests

url = "https://api.ttapi.io/midjourney/v1/imagine"

payload = {
    "prompt": "A cute kitten",
    "mode": "fast",
    "hookUrl": "<string>"
}
headers = {
    "TT-API-KEY": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

const options = {
  method: "POST",
  headers: {
    "TT-API-KEY": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    prompt: "A cute kitten",
    mode: "fast",
    hookUrl: "<string>"
  })
};

fetch("https://api.ttapi.io/midjourney/v1/imagine", options)
  .then((res) => res.json())
  .then((res) => console.log(res))
  .catch((err) => console.error(err));

HttpResponse<String> response = Unirest.post("https://api.ttapi.io/midjourney/v1/imagine")
  .header("TT-API-KEY", "YOUR_API_KEY")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A cute kitten\",\n  \"mode\": \"fast\",\n  \"hookUrl\": \"<string>\"\n}")
  .asString();

Sample response

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "b8bd3ff0-4349-4b71-8938-5e13aefa64fe"
  }
}

Step 2: Fetch the task result

Use the returned jobId to poll the result:

curl -X GET "https://api.ttapi.io/midjourney/v1/fetch?jobId={jobId}" \
  -H "TT-API-KEY: YOUR_API_KEY"

import requests

url = "https://api.ttapi.io/midjourney/v1/fetch"
headers = {"TT-API-KEY": "YOUR_API_KEY"}
params = {"jobId": "jobId"}

response = requests.get(url, headers=headers, params=params)
print(response.status_code)
print(response.json())

const options = {
  method: "GET",
  headers: {"TT-API-KEY": "YOUR_API_KEY"}
};

fetch("https://api.ttapi.io/midjourney/v1/fetch?jobId={jobId}", options)
  .then((res) => res.json())
  .then((res) => console.log(res))
  .catch((err) => console.error(err));

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.ttapi.io/midjourney/v1/fetch?jobId={jobId}")
  .get()
  .addHeader("TT-API-KEY", "YOUR_API_KEY")
  .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());

Sample response

{
  "status": "SUCCESS",
  "message": "",
  "jobId": "8ddd973f-b5ff-4192-b418-b37fb65c65f3",
  "data": {
    "action": "imagine",
    "jobId": "8ddd973f-b5ff-4192-b418-b37fb65c65f3",
    "progress": "100",
    "prompt": "A cute kitten",
    "quota": "2",
    "discordImage": "https://cdn.ttapi.io/midjourney/2025-11-14/20260307_024522_19cf9806e1c7438b.png",
    "cdnImage": "https://cdn.ttapi.io/midjourney/2025-11-14/20260307_024522_19cf9806e1c7438b.png",
    "width": 960,
    "height": 1200,
    "hookUrl": "https://webhook-test.com/40bb50795afa242aee8c837617cd72e9",
    "components": [
      "upsample1", "upsample2", "upsample3", "upsample4", "reroll", "variation1", "variation2", "variation3", "variation4"
    ],
    "seed": null,
    "images": [
      "https://cdn.ttapi.io/midjourney/20260307/5c7261ec-7271-495d-a0f7-4dd395652a84tl.png",
      "https://cdn.ttapi.io/midjourney/20260307/5c7261ec-7271-495d-a0f7-4dd395652a84tr.png",
      "https://cdn.ttapi.io/midjourney/20260307/5c7261ec-7271-495d-a0f7-4dd395652a84bl.png",
      "https://cdn.ttapi.io/midjourney/20260307/5c7261ec-7271-495d-a0f7-4dd395652a84br.png"
    ]
  }
}

Task statuses

Status	Meaning
`PENDING_QUEUE`	Waiting in queue
`ON_QUEUE`	Being processed
`SUCCESS`	Completed successfully
`FAILED`	Failed

Popular next steps

Start the Suno API Quickstart if you want to generate music instead of images.
Read the Suno async workflow guide if your integration relies on webhooks or polling.
Read the Suno workflow guide when you need the right Suno endpoint for your product.

Need help?

For queue and concurrency limits, see Queue
For request signing and headers, see Gateway & Auth
For support, see Contact

Getting Started

Developer

FAQ

Product Guides

Resources

TTAPI Quick Start | AI API Integration Guide (Image, Video, Audio, LLM APIs)

1. Get your API key

Step 1: Create your account

Step 2: Basic account setup

2. Add the request header

3. Send your first request

Step 1: Submit a generation request

Sample response

Step 2: Fetch the task result

Sample response

Task statuses

Popular next steps

Need help?

​1. Get your API key

​Step 1: Create your account

​Step 2: Basic account setup

​2. Add the request header

​3. Send your first request

​Step 1: Submit a generation request

​Sample response

​Step 2: Fetch the task result

​Sample response

​Task statuses

​Popular next steps

​Need help?

1. Get your API key

Step 1: Create your account

Step 2: Basic account setup

2. Add the request header

3. Send your first request

Step 1: Submit a generation request

Sample response

Step 2: Fetch the task result

Sample response

Task statuses

Popular next steps

Need help?