Prompt Enhancer

Enhance your prompts with our Prompt Enhancer, optimizing your instructions for greater efficiency and effectiveness in your image generation tasks.

Introduction

Prompt enhancement is a powerful tool designed to refine and diversify the results generated for a specific topic. By incorporating additional keywords into a given prompt, this feature aims to expand the scope and creativity of the generated images.

It's important to note that while prompt enhancement can produce varied results, it may not always maintain the exact subject focus of the original prompt and does not guarantee superior outcomes compared to the original input.

Request

Our API always accepts an array of objects as input, where each object represents a specific task to be performed. The structure of the object varies depending on the type of the task. For this section, we will focus on the parameters related to the prompt enhancement task.

The following JSON snippets shows the basic structure of a request object. All properties are explained in detail in the next section.

[
  {
    "taskType": "promptEnhance",
    "taskUUID": "9da1a4ad-c3de-4470-905d-5be5c042f98a",
    "prompt": "dog",
    "promptMaxLength": 64,
    "promptVersions": 4
  }
]

taskType

string required

The type of task to be performed. For this task, the value should be promptEnhance.

taskUUID

string required UUID v4

When a task is sent to the API you must include a random UUID v4 string using the taskUUID parameter. This string is used to match the async responses to their corresponding tasks.

If you send multiple tasks at the same time, the taskUUID will help you match the responses to the correct tasks.

The taskUUID must be unique for each task you send to the API.

includeCost

boolean Default: false

If set to true, the cost to perform the task will be included in the response object.

prompt

string required Min: 1 Max: 300

The prompt that you intend to enhance.

promptMaxLength

integer required Min: 12 Max: 400

Represents the maximum length of the enhanced prompt that you intend to receive.

promptVersions

integer required Min: 1 Max: 5

The number of prompt versions that will be received.

Response

Results will be delivered in the format below.

{
  "data": [
    {
      "taskType": "promptEnhance",
      "taskUUID": "9da1a4ad-c3de-4470-905d-5be5c042f98a",
      "text": "dog, ilya kuvshinov, gaston bussiere, craig mullins, simon bisley, arthur rackham",
      "cost": 0
    },
    {
      "taskType": "promptEnhance",
      "taskUUID": "9da1a4ad-c3de-4470-905d-5be5c042f98a",
      "text": "dog, ilya kuvshinov, artgerm",
      "cost": 0
    },
    {
      "taskType": "promptEnhance",
      "taskUUID": "9da1a4ad-c3de-4470-905d-5be5c042f98a",
      "text": "dog, ilya kuvshinov, gaston bussiere, craig mullins, simon bisley",
      "cost": 0
    },
    {
      "taskType": "promptEnhance",
      "taskUUID": "9da1a4ad-c3de-4470-905d-5be5c042f98a",
      "text": "dog, ilya kuvshinov, artgerm, krenz cushart, greg rutkowski, pixiv. cinematic dramatic atmosphere, sharp focus, volumetric lighting, cinematic lighting, studio quality",
      "cost": 0
    }
  ]
}

taskType

string

The API will return the taskType you sent in the request. In this case, it will be promptEnhance. This helps match the responses to the correct task type.

taskUUID

string UUID v4

The API will return the taskUUID you sent in the request. This way you can match the responses to the correct request tasks.

text

string

The enhanced text/prompt response.

cost

float

if includeCost is set to true, the response will include a cost field for each task object. This field indicates the cost of the request in USD.