API Documentation / Text Enhance

Text-Enhance

Overview

The Text-Enhance API allows your app to enhance text using AI models. It converts your input prompts into Tag format or transforms them into sentences with specific emotions.

Tag Booster

Converts your input prompts and settings into tag format suitable for image generation

Parameters

text

·

string

required

The text you want to convert to a tag. The text should not exceed more than 3000 characters.

Example:

"A man standing in a meadow. The background is sky and sunset"

tag_length

·

string

required

Tag length: must be 'short' or 'long'.

Example:

"short"

ban_tags

·

string

optional

Length should not exceed more than 3000 characters. If you want to ban a tag, you can add it to the ban_tags parameter.

Example:

"worst quality, low quality, lowers, low details, bad quality, poorly drawn, bad anatomy, multiple views, bad hands, blurry, artist sign, weibo username, nsfw"

format

·

string

required

Formats to be included in tags. At least one of the following formats must be included:
<|special|>
<|characters|>
<|copyrights|>
<|artist|>
<|general|>
<|quality|>
<|meta|>
<|rating|>

Example:

"<|special|>, <|characters|>, <|quality|>, <|meta|>, <|rating|>"

temperature

·

integer

required

Temperature must be a number between 0 and 2 in steps of 0.1

Example:

0.1

top_p

·

integer

required

Top P must be a number between 0 and 1 in steps of 0.1

Example:

0.1

top_k

·

integer

required

Top K must be a number between 1 and 32,012.

Example:

1

seed

·

integer

required

Seed must be a number between -1 and 4,294,967,295. If you enter -1, a random seed will be used.

Example:

-1

Status Codes

All API queries return HTTP status codes that can tell you more about the response.

201 Created

The request was successful.

400 Bad Request

The request was invalid or cannot be otherwise served. An accompanying error message will explain further.

429 Too Many Requests

The request was rate limited. Please try again later.

404 Not Found

The requested resource was not found.

500 Internal Server Error

The server encountered an error. Please try again later or contact support.

Post

/text-enhance/tag-booster

Copied!
1
Content-Type: application/json
x-illustrious-api-key: YOUR_API_KEY

{
  “text”: "A man standing in a meadow. The background is sky and sunset",
  “tag_length”: "long",
  “ban_tags”: "worst quality, low quality, lowers, low details, bad quality, poorly drawn, bad anatomy, multiple views, bad hands, blurry, artist sign, weibo username, nsfw",
  “format”: "<|special|>, <|characters|>, <|quality|>, <|meta|>, <|rating|>",
  “temperature”: 0.7,
  “top_p”: 1.0,
  “top_k”: 1.0,
  “seed”: -1,
}

Response

Copied!
1
{
  “output”: “A pink-haired girl waves with a smile, dressed in a metallic jacket and a short dress, as the sun sets over a stunning sea behind her., :d, blue sky, long sleeves, sunlight, pink hair, arm up, solo, dress, smile,  1girl, horizon, jacket, long hair, blue dress, blue eyes, ocean, waving, sky, open mouth, outdoors, day, upper body, cloud, looking at viewer, sun”
}

Mood enhancer

Converts your input prompts into sentences with specific emotions

Parameters

text

·

string

required

The text you want to change. The text should not exceed more than 3000 characters.

Example:

"A man standing in a meadow. The background is sky and sunset"

Status Codes

All API queries return HTTP status codes that can tell you more about the response.

201 Created

The request was successful.

400 Bad Request

The request was invalid or cannot be otherwise served. An accompanying error message will explain further.

429 Too Many Requests

The request was rate limited. Please try again later.

404 Not Found

The requested resource was not found.

500 Internal Server Error

The server encountered an error. Please try again later or contact support.

Post

/text-enhance/mood-enhancer

Copied!
1
Content-Type: application/json
x-illustrious-api-key: YOUR_API_KEY

{
  “text”: “masterpiece, extremely aesthetic, newest, very vibrant colors”,
}

Response

Copied!
1
{
  “output”: “A vibrant girl with pink hair waves with a smile, dressed in a metallic jacket and a short dress. The sun sets behind her over a stunning sea, casting warm, golden hues across the scene. Her hair catches the light, glowing softly, while the metallic jacket reflects the sunset's colors. The atmosphere is serene and picturesque, with the sea shimmering under the fading light, creating a dreamy and inviting backdrop., pink hair,metallic jacket,sunset,smiling girl,sea background”
}

by Onoma AI

Address : 201, 2F, D-dong, 47, Maeheon-ro 8-gil, Seocho-gu, Seoul, 06770, Rep. of KOREA

Business Registration Certificate : 450-86-02454

CEO : Min Song

Contact : illustrious@onomaai.com