Text to Image

For more detailed information on the available text-to-image models, please refer to the Text to Image section.

Text to Image API

POST /getTextToImage

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Body

Name
Type
Description

app_id

string

-> Each model is uniquely characterized by its own app_id.

height

int

-> The height parameter represents the vertical dimension of an image.

-> The valid range for the parameter is between 256 and 1536 pixels.

width

int

-> The width parameter represents the horizontal dimension of an image.

-> The valid range for the parameter is between 256 and 1536 pixels.

num_inference_steps

int

-> The num_inference_steps parameter represents the number of denoising iterations to perform during the image generation process. Generally, more iterations can result in higher-quality images, but they also increase the time required for generation.

-> The valid range for the num_inference_steps parameter is between 1 and 50.

guidance_scale

float

-> The guidance_scale parameter determines how closely the generated image adheres to the provided prompt. Higher values result in the model following the prompt more closely, while lower values allow for more creative deviation.

-> The valid range for the guidance_scale parameter is between 1 and 30.

batch

int

-> The batch parameter allows you to specify the number of images to generate at once.

-> The valid range for this parameter is between 1 and 8.

prompt

string

-> The prompt parameter is the textual input that guides the image generation process. This prompt serves as an artistic compass, shaping the visual output.

negative_prompt

string

-> The negative_prompt parameter allows you to specify content that you want the image generation model to avoid or minimize in the output. This can be useful for excluding certain visual elements or styles that you do not want to be present in the generated image.

celery

bool

-> The celery parameter is used for queuing tasks that require extended processing time. When you enqueue a task, you receive a unique task_id. This task_id allows you to check the task's status later using the task status API, which is useful for managing and tracking long-running tasks.

inference_type

string

-> The inference_type parameter allows you to specify the GPU to be used for the image generation task. The supported values are:

  • a10g

  • a100

  • h100

This parameter is only applicable for Qolaba-deployed models, including Turbo Vision, Qolaba Style, Cartoon, Realistic, and Anime Style.

The different GPU options provide varying levels of performance and capabilities, allowing you to choose the most suitable GPU based on your requirements and the demand for the task.

APP ids for different Text to Image styles

App ID
Model Name
Height and Width Constraints

ap-JOsvgUBfInC2UQnz0FQFkG

Turbo Vision

The height and width parameters must be multiples of 8 pixels.

ap-PZYd1Bb5QH57Rw4BF0dPA4

Qolaba Style

The height and width parameters must be multiples of 8 pixels.

ap-VbAWaTpRHAcfqywOmcjN2y

Cartoon Style

The height and width parameters must be multiples of 8 pixels.

ap-uU4Xo4z6KgFHFjW9gnAl3q

Realistic Style

The height and width parameters must be multiples of 8 pixels.

ap-7vTmulaxjyiCzQEj1BOOvJ

Anime Style

The height and width parameters must be multiples of 8 pixels.

ap-oDVXRQ7bCaWW05O52P1mlA

SDXL Style

The API supports the following combinations of height and width parameters:

  • 1024x1024

  • 1536x640

  • 1344x768

  • 1216x832

  • 1152x896

  • 896x1152

  • 832x1216

  • 768x1344

  • 640x1536

Please ensure that the values you provide for height and width match one of these supported combinations.

ap-Xm3pLZVdE8gY4WbR1TcSjQ

SDXL3 Style

For SDXL 3, the API supports the following aspect ratios for the height and width parameters:

  • 16:9

  • 1:1

  • 21:9

  • 2:3

  • 3:2

  • 4:5

  • 5:4

  • 9:16

  • 9:21

When providing the height and width values, please ensure that the resulting aspect ratio matches one of the supported ratios in the list above.

ap-Nk4rV9bTzXq5YH2JpL3fWg

SDXL3 Turbo Style

For SDXL 3, the API supports the following aspect ratios for the height and width parameters:

  • 16:9

  • 1:1

  • 21:9

  • 2:3

  • 3:2

  • 4:5

  • 5:4

  • 9:16

  • 9:21

When providing the height and width values, please ensure that the resulting aspect ratio matches one of the supported ratios in the list above.

ap-sdSyd0idsndjnsnsndjsds

Dalle 3

The API supports the following height and width parameter combinations for DALL-E 3:

  • 1792x1024

  • 1024x1024

  • 1024x1792

Please ensure that the height and width values you provide match one of these supported combinations.

Response

{
  "time_required": "",
  "error": "",
  "error_data": "",
  "input": "",
  "output": "",
  "app_id": "",
  "task_id": "",
  "status": ""
}

Run the API

To test this API, please use the following link:

PreviousAPI PlatformNextImage to Image

Last updated