Docs
image
Text To Image

Text to Image

The Text to Image Generation API provides a simple yet powerful interface for converting text into amazing images.

Endpoint

POST /image/v1/text-to-image

Body

  • prompt (string, required): The text input to be converted into speech.
  • numberOfResults (number, required): The number of images to generate [1-10].
  • imageSizeId (string, optional): The ID of the image size. The following size IDs are accepted::
    • 6644b0c5ec3658a8e38d951b 2:3
    • 6644b0c5ec3658a8e38d951c 1:1
    • 6644b0c5ec3658a8e38d951d 3:2
    • 6644b0c5ec3658a8e38d951e 4:3
    • 6644b0c5ec3658a8e38d951f 3:4
    • 6644b0c5ec3658a8e38d9520 16:9
    • 6644b0c5ec3658a8e38d9521 9:16
    • 6644b0c5ec3658a8e38d9522 20:9
    • 6644b0c5ec3658a8e38d9523 9:20
    • 6644b0c5ec3658a8e38d9524 2:1
    • 6644b0c5ec3658a8e38d9525 1:2
    • 6644b0c5ec3658a8e38d9526 5:4
    • 6644b0c5ec3658a8e38d9527 4:5
  • styleId (string, optional): The ID of the image style. The following styles IDs are accepted::
    • 6644b0c5ec3658a8e38d94ec Photo
    • 6644b0c5ec3658a8e38d94ed Digital Art
    • 6644b0c5ec3658a8e38d94ee 3D
    • 6644b0c5ec3658a8e38d94ef Painting
    • 6644b0c5ec3658a8e38d94f0 Low Poly
    • 6644b0c5ec3658a8e38d94f1 Pixel Art
    • 6644b0c5ec3658a8e38d94f2 Anime
    • 6644b0c5ec3658a8e38d94f3 Cyberpunk
    • 6644b0c5ec3658a8e38d94f4 Comic
    • 6644b0c5ec3658a8e38d94f5 Vintage
    • 6644b0c5ec3658a8e38d94f6 Cartoon
    • 6644b0c5ec3658a8e38d94f7 Vector
    • 6644b0c5ec3658a8e38d94f8 Studio Shot
    • 6644b0c5ec3658a8e38d94f9 Dark
    • 6644b0c5ec3658a8e38d94fa Sketch
    • 6644b0c5ec3658a8e38d94fb Mockup
    • 6644b0c5ec3658a8e38d94fc 2000s Phone
    • 6644b0c5ec3658a8e38d94fd 70s Vibe
    • 6644b0c5ec3658a8e38d94fe Watercolor
    • 6644b0c5ec3658a8e38d94ff Art Nouveau
    • 6644b0c5ec3658a8e38d9500 Origami
    • 6644b0c5ec3658a8e38d9501 Surreal
    • 6644b0c5ec3658a8e38d9502 Fantasy
    • 6644b0c5ec3658a8e38d9503 Traditional Japan
  • cameraId (string, optional): The ID of the camera style. The following camera IDs are accepted::
    • 6644b0c5ec3658a8e38d952c Portrait
    • 6644b0c5ec3658a8e38d952d Close Up
    • 6644b0c5ec3658a8e38d952e Cinematic
    • 6644b0c5ec3658a8e38d952f Panoramic
    • 6644b0c5ec3658a8e38d9530 Low Angle
    • 6644b0c5ec3658a8e38d9531 Symmetry
    • 6644b0c5ec3658a8e38d9532 Mid Shot
    • 6644b0c5ec3658a8e38d9533 Full Body
    • 6644b0c5ec3658a8e38d9534 Fish Eye
    • 6644b0c5ec3658a8e38d9535 First Person
    • 6644b0c5ec3658a8e38d9536 High Angle
  • colorId (string, optional): The ID of the color style. The following color IDs are accepted::
    • 6644b0c5ec3658a8e38d9502 Sepia
    • 6644b0c5ec3658a8e38d9503 Black and White
    • 6644b0c5ec3658a8e38d9504 Red and Blue
    • 6644b0c5ec3658a8e38d9505 Autumn
    • 6644b0c5ec3658a8e38d9506 Burgundy and Blue
    • 6644b0c5ec3658a8e38d9507 Pastel
    • 6644b0c5ec3658a8e38d9508 Vibrant
    • 6644b0c5ec3658a8e38d9509 Pastel Pink
    • 6644b0c5ec3658a8e38d950a Cold Neon
    • 6644b0c5ec3658a8e38d950b Deep Teal
    • 6644b0c5ec3658a8e38d950c Muted Green
    • 6644b0c5ec3658a8e38d950d Terracotta and Teal
    • 6644b0c5ec3658a8e38d950e Dramatic
    • 6644b0c5ec3658a8e38d950f Film Filter
    • 6644b0c5ec3658a8e38d9510 Split
    • 6644b0c5ec3658a8e38d9511 Electric
    • 6644b0c5ec3658a8e38d9512 Duotone
  • lightingId (string, optional): The ID of the lighting style. The following lighting IDs are accepted::
    • 6644b0c5ec3658a8e38d9538 Studio
    • 6644b0c5ec3658a8e38d9539 Warm
    • 6644b0c5ec3658a8e38d953a Cinematic
    • 6644b0c5ec3658a8e38d953b Volumetric
    • 6644b0c5ec3658a8e38d953c Golden Hour
    • 6644b0c5ec3658a8e38d953d Long Exposure
    • 6644b0c5ec3658a8e38d953e Cold
    • 6644b0c5ec3658a8e38d953f Iridescent
    • 6644b0c5ec3658a8e38d9540 Dramatic
    • 6644b0c5ec3658a8e38d9541 Hard Light
    • 6644b0c5ec3658a8e38d9542 Redscale
    • 6644b0c5ec3658a8e38d9543 Indoor Light

Example

Request

POST /image/v1/text-to-image
Content-Type: application/json
x-access-key: YOUR_ACCESS_KEY
{
    "prompt": "<Input text>",
    "dimensionsId": "<one of the dimensions IDs>",
    "numberOfResults": <Number of images to generate 1-10>,
    "styleId": "<one of the styles IDs>"
}

Response

Success
HTTP/1.1 200 OK
{
    "data": [{"base64": <base64 image>}],
    "success": true,
    "message": "<process success message>"
}
Error
HTTP/1.1 400 Bad Request
Content-Type: application/json
{
    "success": false,
    "message": "<An error message containg the details>"
}