跳转到主要内容

​
1. 获取 API KEY

在调用 API 之前，你需要获取 TT-API-KEY 用于身份认证。获取方式：

​
Step 1：注册你的账户

打开 TTAPI 官网 ，右上角点击 SIGN IN ，或者直接打开 TTAPI Dashboard 登录页面，选择 Github 或者 Google 账户注册/登录。
如果选择google账户注册/登录，需要有外网访问环境，否则页面会超时！目前不支持常规邮箱注册
  • 注册成功后，将会收到TTAPI的官方邮件通知并跳转 Dashboard 主页，默认生成一个 TT-API-KEY，这个key将会应用在TTAPI中所有接口的鉴权
  • 并且默认获得 30 quota (≈$0.3) 的试用额度，页面中会显示当前剩余额度

​
Step 2：使用你的账户

我们建议首次注册使用之前修改您的默认TT-API-KEY，控制面板主页点击“RESET”，确认并提交修改您的默认KEY
如果您后续不希望使用 github 或者 google 一键登录，可以在 登录页面 点击“忘记密码？”，通过接收注册邮箱中的验证码修改您的登录密码，后续可以进行账户密码登录

​
2. 设置请求头

所有 API 请求都必须在请求头中包含 TT-API-KEY 进行身份认证。 
TT-API-KEY: YOUR_API_KEY

​
3. 发送第一个请求

​
第一步：发送生成请求

下面是一个简单的图像生成 API 调用示例。 
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": "一只可爱的猫咪",
  "mode": "fast",
  "hookUrl": "<string>"
}
'

​
响应示例

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

​
第二步：检查任务状态

通过第一步返回的任务ID（jobId）查询生成结果： 
curl -X GET https://api.ttapi.io/midjourney/v1/fetch?jobId={jobId} \
-H "TT-API-KEY: YOUR_API_KEY" \

​
响应示例

{
    "status": "SUCCESS",
    "message": "",
    "jobId": "8ddd973f-b5ff-4192-b418-b37fb65c65f3",
    "data": {
        "action": "imagine",
        "jobId": "8ddd973f-b5ff-4192-b418-b37fb65c65f3",
        "progress": "100",
        "prompt": "一只可爱的猫咪",
        "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"
        ]
    }
}

​
任务状态说明

PENDING_QUEUE任务正在队列中等待
ON_QUEUE任务正在处理中
SUCCESS任务成功完成
FAILED任务执行失败

​
帮助及说明

Last modified on March 12, 2026