Flux API

Flux.1 是由前Stability AI工程师创立的初创公司Black Forest Labs开发的一种先进的文本到图像合成模型。TTAPI现支持API形式供开发者使用 Flux API 。

Flux 生成图像

POST https://api.ttapi.io/flux/generate

根据文本提示使用Flux.1模型生成图像。注意,该接口与Midjourney的区别是单次只能生成一张图片

Headers

NameValue

Content-Type

application/json

TT-API-KEY

用于请求授权 TT-API 的API密钥

Body

参数类型是否必须描述

prompt

string

生成图像描述词 注意:Flux支持多语言理解能力,但实测英文最佳。

size

string

图像尺寸,可选范围:

1024x1024

1024x1792

1792x1024 不同尺寸消耗quota也不同,详见

mode

string

模型版本,可选范围: flux1-dev flux1-schnell flux1-pro 其中flux1-schnell生成速度最为快,flux1-pro生成质量最为优秀

hookUrl

string

生成图像结果异步通知地址

注意:Flux生成图像接口同步返回的并不是任务的最终结果,任务的最终返回结果需要使用hookUrl参数接收异步通知,或者通过Flux查询任务结果接口进行查询。

请求示例

import requests

endpoint = "https://api.ttapi.io/flux/generate"

headers = {
    "TT-API-KEY": your_key
}

data = {
    "prompt": "a cute cat",
    "size": "1024x1024",
    "mode": "flux1-dev"
}

response = requests.post(endpoint, headers=headers, json=data)

print(response.status_code)
print(response.json())

返回示例

{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "jobId": "fac30d6c-d12b-465c-a580-8b1b3ae726e3"
    }
}

Flux 获取图像结果

POST https://api.ttapi.io/flux/fetch

根据生成图像接口返回的jobId获取任务的最终结果,此接口免费

Headers

NameValue

Content-Type

application/json

TT-API-KEY

用于请求授权 TT-API 的API密钥

Body

参数类型是否必须描述

jobId

string

生成图像接口同步返回的jobId

请求示例

import requests

endpoint = "https://api.ttapi.io/flux/fetch"

headers = {
    "TT-API-KEY": your_key
}

data = {
    "jobId": "bf165abb-a7fa-4c77-a2e4-138baac1130d"
}

response = requests.post(endpoint, headers=headers, json=data)

print(response.status_code)
print(response.json())

返回示例

{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "bf165abb-a7fa-4c77-a2e4-138baac1130d",
    "data": {
        "mode": "flux-dev",
        "jobId": "bf165abb-a7fa-4c77-a2e4-138baac1130d",
        "prompt": "漂亮的亚洲女孩和一只猫的合影",
        "quota": "1",
        "size": "1024x1024",
        "imageUrl": "https://cdnb.ttapi.io/2024-09-10/9rk3gmw3m6sxm4r75my02r48jizyli1l.webp",
        "hookUrl": "https://webhook-test.com/d47a918bcf231bfd4dcd1f63c2cb4c80"
    }
}

返回JSON结构详解

namevalue

status

ON_QUEUE //执行中

SUCCESS //成功 FAILED //失败

imageUrl

生成图像地址,有效期一个月,请自行转存

quota

实际消耗额度

Last updated