Office Format

Flux Kontext Max

POST https://api.ttapi.io/bfl/v1/flux-kontext-max

Edit or create an image with Flux Kontext Max

Headers

Name	Type	Required	Description
TT-API-KEY	String	true	Your API Key in TT API used for request authorization

Request Body

Name	Type	Required	Description
prompt	String	true	Text prompt for image generation.
input_image	String	false	Base64 encoded image or URL to use with Kontext.
input_image_2	String	false	Base64 encoded image or URL to use with Kontext. Experimental Multiref
input_image_3	String	false	Base64 encoded image or URL to use with Kontext. Experimental Multiref
input_image_4	String	false	Base64 encoded image or URL to use with Kontext. Experimental Multiref
aspect_ratio	String	false	Aspect ratio of the image between `21:9` and `9:21`
seed	Integer	false	Optional seed for reproducibility.
output_format	String	false	Output format for the generated image. Can be 'jpeg' or 'png'. Available options: `jpeg`, `png` default: `png`
prompt_upsampling	Boolean	false	Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation. default: `false`
safety_tolerance	Integer	false	Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict. default: `2`
webhook_url	String	false	URL to receive webhook notifications Required string length: 1 - 2083

Example Response

{
    "status": "SUCCESS",
    "message": "",
    "data": {
        "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
    }
}

Flux Kontext Pro

POST https://api.ttapi.io/bfl/v1/flux-kontext-pro

Edit or create an image with Flux Kontext Pro

Headers

Name	Type	Required	Description
TT-API-KEY	String	true	Your API Key in TT API used for request authorization

Request Body

Name	Type	Required	Description
prompt	String	true	Text prompt for image generation.
input_image	String	false	Base64 encoded image or URL to use with Kontext.
input_image_2	String	false	Base64 encoded image or URL to use with Kontext. Experimental Multiref
input_image_3	String	false	Base64 encoded image or URL to use with Kontext. Experimental Multiref
input_image_4	String	false	Base64 encoded image or URL to use with Kontext. Experimental Multiref
aspect_ratio	String	false	Aspect ratio of the image between `21:9` and `9:21`
seed	Integer	false	Optional seed for reproducibility.
output_format	String	false	Output format for the generated image. Can be 'jpeg' or 'png'. Available options: `jpeg`, `png` default: `png`
prompt_upsampling	Boolean	false	Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation. default: `false`
safety_tolerance	Integer	false	Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict. default: `2`
webhook_url	String	false	URL to receive webhook notifications Required string length: 1 - 2083

Example Response

{
    "status": "SUCCESS",
    "message": "",
    "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
}
}

Flux Pro 1.1 Ultra

POST https://api.ttapi.io/bfl/v1/flux-pro-1.1-ultra

Generate an image with FLUX 1.1 [pro] with ultra mode and optional raw mode.

Headers

Name	Type	Required	Description
TT-API-KEY	String	true	Your API Key in TT API used for request authorization

Request Body

Name	Type	Required	Description
prompt	String	true	Text prompt for image generation.
aspect_ratio	String	false	Aspect ratio of the image between `21:9` and `9:21`
image_prompt	String	false	Optional image to remix in base64 format
image_prompt_strength	Number	false	Blend between the prompt and the image prompt Required range: 0 - 1 default:`0.1`
raw	Boolean	false	Generate less processed, more natural-looking images default: `false`
seed	Integer	false	Optional seed for reproducibility.
output_format	String	false	Output format for the generated image. Can be 'jpeg' or 'png'. Available options: `jpeg`, `png` default: `png`
prompt_upsampling	Boolean	false	Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation. default: `false`
safety_tolerance	Integer	false	Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict. default: `2`
webhook_url	String	false	URL to receive webhook notifications Required string length: 1 - 2083

Example Response

{
    "status": "SUCCESS",
    "message": "",
    "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
}
}

Flux Pro 1.1

POST https://api.ttapi.io/bfl/v1/flux-pro-1.1

Submits an image generation task with FLUX 1.1 [pro].

Headers

Name	Type	Required	Description
TT-API-KEY	String	true	Your API Key in TT API used for request authorization

Request Body

Name	Type	Required	Description
prompt	String	true	Text prompt for image generation.
image_prompt	String	false	Optional image to remix in base64 format
width	Integer	false	Width of the generated image in pixels. Must be a multiple of 32. Required range: 256 - 1440 default: `1024`
height	Integer	false	Height of the generated image in pixels. Must be a multiple of 32. Required range: 256 - 1440 default: `768`
seed	Integer	false	Optional seed for reproducibility.
output_format	String	false	Output format for the generated image. Can be 'jpeg' or 'png'. Available options: `jpeg`, `png` default: `png`
prompt_upsampling	Boolean	false	Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation. default: `false`
safety_tolerance	Integer	false	Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict. default: `2`
webhook_url	String	false	URL to receive webhook notifications Required string length: 1 - 2083

Example Response

{
    "status": "SUCCESS",
    "message": "",
    "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
}
}

Flux Pro

POST https://api.ttapi.io/bfl/v1/flux-pro

Submits an image generation task with FLUX 1.1 [pro].

Headers

Name	Type	Required	Description
TT-API-KEY	String	true	Your API Key in TT API used for request authorization

Request Body

Name	Type	Required	Description
prompt	String	true	Text prompt for image generation.
image_prompt	String	false	Optional image to remix in base64 format
width	Integer	false	Width of the generated image in pixels. Must be a multiple of 32. Required range: 256 - 1440 default: `1024`
height	Integer	false	Height of the generated image in pixels. Must be a multiple of 32. Required range: 256 - 1440 default: `768`
seed	Integer	false	Optional seed for reproducibility.
output_format	String	false	Output format for the generated image. Can be 'jpeg' or 'png'. Available options: `jpeg`, `png` default: `png`
prompt_upsampling	Boolean	false	Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation. default: `false`
safety_tolerance	Integer	false	Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict. default: `2`
steps	Integer	false	Number of steps for the image generation process. Required range: 1 - 50 default: `40`
guidance	Number	false	Guidance scale for image generation. High guidance scales improve prompt adherence at the cost of reduced realism. Required range: 1.5 - 5 default: `2.5`
interval	Number	false	Interval parameter for guidance control. Required range: 1 - 4 default: `2`
webhook_url	String	false	URL to receive webhook notifications Required string length: 1 - 2083

Example Response

{
    "status": "SUCCESS",
    "message": "",
    "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
}
}

Flux Dev

POST https://api.ttapi.io/bfl/v1/flux-dev

Submits an image generation task with FLUX.1 [dev].

Headers

Name	Type	Required	Description
TT-API-KEY	String	true	Your API Key in TT API used for request authorization

Request Body

Name	Type	Required	Description
prompt	String	true	Text prompt for image generation.
image_prompt	String	false	Optional image to remix in base64 format
width	Integer	false	Width of the generated image in pixels. Must be a multiple of 32. Required range: 256 - 1440 default: `1024`
height	Integer	false	Height of the generated image in pixels. Must be a multiple of 32. Required range: 256 - 1440 default: `768`
seed	Integer	false	Optional seed for reproducibility.
output_format	String	false	Output format for the generated image. Can be 'jpeg' or 'png'. Available options: `jpeg`, `png` default: `png`
prompt_upsampling	Boolean	false	Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation. default: `false`
safety_tolerance	Integer	false	Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict. default: `2`
steps	Integer	false	Number of steps for the image generation process. Required range: 1 - 50 default: `40`
guidance	Number	false	Guidance scale for image generation. High guidance scales improve prompt adherence at the cost of reduced realism. Required range: 1.5 - 5 default: `2.5`
webhook_url	String	false	URL to receive webhook notifications Required string length: 1 - 2083

Example Response

{
    "status": "SUCCESS",
    "message": "",
    "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
}
}

Fetch Flux Result

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

Get the flux generate image task result, the returned json data is same with the return in webhook_url

Headers

Name	Type	Description
TT-API-KEY*	String	Your API Key in TT API used for request authorization

Request Body / Query param

Name	Type	Required	Description
jobId	String	true	ed1a1b01-7d64-4c8a-acaa-71185d23a2f3

Async callback & fetch json

{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "8c117b9d-f216-43d1-8d66-c3a1dfe60585",
    "data": {
        "mode": "flux-kontext-max",
        "jobId": "8c117b9d-f216-43d1-8d66-c3a1dfe60585",
        "prompt": "It is important to maintain picture resemblance. Don't add text if it's not in the additional requirements. Consider all uploaded reference images for generation. Cinematic style. Additional requirements: В целом хочу получить картинку как первое добавленное мною фото, ничего меня не нужно. Нужно только заменить персонажа девушку, на девушку в втором фото мною прикрепленном",
        "quota": "5",
        "size": null,
        "seed": "933630001",
        "imageUrl": "https://cdn.ttapi.io/flux/2025-10-14/63cf8774-d5b8-4814-9adb-7a85f298d773.png",
        "hookUrl": null
    }
}

TTAPI format Generate & Fetch