Skip to main content

Text to Image Endpoint

Overview​

Real-Time Text-to-Image API Endpoint​

Use Case: Rapid image generation with standard quality.

Open in Playground 🚀

Generation Time: 2-3 seconds.

Description: This endpoint delivers fast image generation with normal quality, making it ideal for applications where speed is more critical than high resolution.

Text to image endpoint result

Request​

--request POST 'https://modelslab.com/api/v6/realtime/text2img' \

Make a POST request to https://modelslab.com/api/v6/realtime/text2img endpoint and pass the required parameters as a request body.

Watch the Text to Image API Demo video to see it in action Postman.​

Body Attributes​

Here's the updated documentation for the parameters:

ParameterDescription
keyYour API Key is used for request authorization. https://modelslab.com/dashboard/api-keys Open the given link to view your API KEY.
promptThe text prompt provides a description of what you want in the generated image. It tells the AI what to create based on the given instructions.
negative_promptNegative prompts are descriptions of things we don't want in our image. Examples include NSFW content, extra limbs, distorted faces, poor quality, or anything else we want to avoid.
widthWidth define the size of the generated image Width: 1024x1024.
heightHeight define the size of the generated image Height: 1024x1024.
samplesNumber of sample images to be returned in response. The maximum value is 4.
safety_checkerA NSFW image checker ensures that any inappropriate content detected will be replaced with a blank image to maintain a safe and appropriate browsing experience. default: true, options: true or false.
seedThe seed is used to reproduce results. Providing the same seed will yield the same image each time. Use "null" for a random number seed.
instant_responseEnable instant response before processing finishes, eliminating the need to wait for a minimum amount of time. default: false, options: true or false.
base64Get response as base64 string, default: false, options: true or false
webhookAssign a URL to receive a POST API call after image generation completes for seamless integration and notification.
track_idThe track ID is returned in the response to the webhook API call. This will be used to identify the webhook request.
enhance_promptEnhance prompts for better results; options: true or false.
enhance_styleThis allows you to set the style of the image for better result. The following are the styles that are available; enhance,cinematic-diva,nude,nsfw,sex,abstract-expressionism,academia,action-figure,adorable-3d-character,adorable-kawaii,art-deco,art-nouveau,astral-aura,avant-garde,baroque,bauhaus-style-poster,blueprint-schematic-drawing,caricature,cel-shaded-art,character-design-sheet,classicism-art,color-field-painting,colored-pencil-art,conceptual-art,constructivism,cubism,dadaism,dark-fantasy,dark-moody-atmosphere,dmt-art,doodle-art,double-exposure,dripping-paint-splatter,expressionism,faded-polaroid-photo,fauvism,flat-2d,fortnite-style,futurism,glitchcore,glo-fi,googie-style,graffiti-art,harlem-renaissance-art,high-fashion,idyllic,impressionism,infographic-drawing,ink-dripping-drawing,japanese-ink-drawing,knolling-photography,light-cheery-atmosphere,logo-design,luxurious-elegance,macro-photography,mandola-art,marker-drawing,medievalism,minimalism,neo-baroque,neo-byzantine,neo-futurism,neo-impressionism,neo-rococo,neoclassicism,op-art,ornate-and-intricate,pencil-sketch-drawing,pop-art-2,rococo,silhouette-art,simple-vector-art,sketchup,steampunk-2,surrealism,suprematism,terragen,tranquil-relaxing-atmosphere,sticker-designs,vibrant-rim-light,volumetric-lighting,watercolor,whimsical-and-playful,sharp,masterpiece,photograph,negative,cinematic,ads-advertising,ads-automotive,ads-corporate,ads-fashion-editorial,ads-food-photography,ads-gourmet-food-photography,ads-luxury,ads-real-estate,ads-retail,abstract,abstract-expressionism,art-deco,art-nouveau,constructivist,cubist,expressionist,graffiti,hyperrealism,impressionist,pointillism,pop-art,psychedelic,renaissance,steampunk,surrealist,typography,watercolor,futuristic-biomechanical,futuristic-biomechanical-cyberpunk,futuristic-cybernetic,futuristic-cybernetic-robot,futuristic-cyberpunk-cityscape,futuristic-futuristic,futuristic-retro-cyberpunk,futuristic-retro,futuristic-sci-fi,futuristic-vaporwave,game-bubble,game-cyberpunk,game-fighting,game-gta,game-mario,game-minecraft,game-pokemon,game-retro-arcade,game-retro,game-rpg-fantasy,game-strategy,game-streetfighter,game-zelda,misc-architectural,misc-disco,misc-dreamscape,misc-dystopian,misc-fairy-tale,misc-gothic,misc-grunge,misc-horror,misc-kawaii,misc-lovecraftian,misc-macabre,misc-manga,misc-metropolis,misc-minimalist,misc-monochrome,misc-nautical,misc-space,misc-stained-glass,misc-techwear-fashion,misc-tribal,misc-zentangle,papercraft-collage,papercraft-flat-papercut,papercraft-kirigami,papercraft-paper-mache,papercraft-paper-quilling,papercraft-papercut-collage,papercraft-papercut-shadow-box,papercraft-stacked-papercut,papercraft-thick-layered-papercut,photo-alien,photo-film-noir,photo-glamour,photo-hdr,photo-iphone-photographic,photo-long-exposure,photo-neon-noir,photo-silhouette,photo-tilt-shift,3d-model,analog-film,anime,cinematic,comic-book,craft-clay,digital-art,fantasy-art,isometric,line-art,lowpoly,neonpunk,origami,photographic,pixel-art,texture,

Example​

Body​

Body
{
  "key": "",
  "prompt": "ultra realistic close up portrait ((beautiful pale cyberpunk female with heavy black eyeliner))",
  "negative_prompt": "bad quality",
  "width": "512",
  "height": "512",
  "safety_checker": false,
  "seed": null,
  "samples": 1,
  "base64": false,
  "webhook": null,
  "track_id": null
}

Request​

var myHeaders = new Headers();
myHeaders.append('Content-Type', 'application/json');

var raw = JSON.stringify({
  key: '',
  prompt:
    'ultra realistic close up portrait ((beautiful pale cyberpunk female with heavy black eyeliner))',
  negative_prompt: 'bad quality',
  width: '512',
  height: '512',
  safety_checker: false,
  seed: null,
  samples: 1,
  base64: false,
  webhook: null,
  track_id: null,
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow',
};

fetch('https://modelslab.com/api/v6/realtime/text2img', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

Response​

{
    "status": "success",
    "generationTime": 1.06,
    "id": 91753437,
    "output": [
        "https://pub-3626123a908346a7a8be8d9295f44e26.r2.dev/generations/f20412ca-cb22-4e77-9b75-26ddbad5a4e5-0.png"
    ],
    "proxy_links": [
        "https://cdn2.stablediffusionapi.com/generations/f20412ca-cb22-4e77-9b75-26ddbad5a4e5-0.png"
    ],
    "meta": {
        "base64": "no",
        "enhance_prompt": "no",
        "enhance_style": null,
        "file_prefix": "f20412ca-cb22-4e77-9b75-26ddbad5a4e5",
        "guidance_scale": 1,
        "height": 512,
        "instant_response": "no",
        "n_samples": 1,
        "negative_prompt": "bad quality",
        "outdir": "out",
        "prompt": "ultra realistic close up portrait ((beautiful pale cyberpunk female with heavy black eyeliner))",
        "safety_checker": "no",
        "safety_checker_type": "black",
        "seed": 3977575608,
        "temp": "no",
        "width": 512
    }
}