Skip to main content

Text to Image Endpoint

Overview​

The Text to Image API is used to create image from text based using flux model. This endpoint generates and returns an image from a text passed in the request body.

Open in Playground 🚀

Text to image endpoint result

Request​

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

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

Watch the how-to video to see it in action.

Body Attributes​

ParameterDescriptionType
keyYour API Key used for request authorization.key
model_idThe ID of the model. Obtain the model ID from the provided source.ID
promptA text description of the things you want in the generated image.string
negative_promptItems you don't want in the image.string
widthThe width of the image. Maximum value is 1024.integer
heightThe height of the image. Maximum value is 1024.integer
samplesThe number of images to be returned in response. The maximum value is 4.integer
num_inference_stepsThe number of denoising steps. values range from 1 to 20, and any value above 20 will be capped at 20.
safety_checkerA checker for NSFW images. If detected, such images will be replaced by a blank image. Default is "yes". Options: "yes"/"no".string
safety_checker_typeModify image if NSFW images are found. Default is "sensitive_content_text". Options: "blur", "sensitive_content_text", "pixelate", "black".string
enhance_styleAllows you to set the style of the image for better results. Available styles include: 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, constructivist, cubist, expressionist, graffiti, hyperrealism, impressionist, pointillism, pop-art, psychedelic, renaissance, steampunk, surrealist, typography, 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.string
seedUsed to reproduce results. The same seed will generate the same image again. Pass null for a random number.integral
guidance_scaleScale for classifier-free guidance. Minimum value is 1, maximum value is 20.integer
algorithm_typeUsed in DPMSolverMultistepScheduler scheduler. Default is "none".string
multi_lingualAllow multilingual prompts to generate images. Set to "yes" if using a language other than English in text prompts.string
panoramaSet to "yes" to generate a panorama image.string
self_attentionIf you want a high-quality image, set to "yes". This will take more time.string
clip_skipClip Skip. Minimum value is 1, maximum value is 8.integer
base64Get response as a base64 string. Default is "no". Options: "yes"/"no".string
schedulerUse to set a scheduler.scheduler
webhookSet a URL to receive a POST API call once image generation is complete.URL
track_idThis ID is returned in the response to the webhook API call and is used to identify the webhook request.ID
tempCreate a temporary image link valid for 24 hours. Options: "yes"/"no".string
Open in Playground 🚀

Flux generations​

Flux Model (Full HD Quality)​

Use Case: High-quality Full HD image generation
Generation Time: 4-5 seconds
Description: The Flux model delivers Full HD images with enhanced visual quality, offering a balance between speed and resolution for high-quality outputs.

Body​

Body
{
  "key": "",
  "model_id": "flux",
  "prompt": "ultra realistic close up portrait ((beautiful pale cyberpunk female with heavy black eyeliner)), blue eyes, shaved side haircut, hyper detail, cinematic lighting, magic neon, dark red city, Canon EOS R3, nikon, f/1.4, ISO 200, 1/160s, 8K, RAW, unedited, symmetrical balance, in-frame, 8K",
  "width": "512",
  "height": "512",
  "samples": "1",
  "num_inference_steps": "31",
  "safety_checker": "no",
  "enhance_prompt": "yes",
  "seed": null,
  "guidance_scale": 7.5,
  "panorama": "no",
  "self_attention": "no",
  "tomesd": "yes",
  "clip_skip": "2",
  "vae": null,
  "webhook": null,
  "track_id": null
}

Request​

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

var raw = JSON.stringify({
  "key": "",
  "model_id": "flux",
  "prompt": "actual 8K portrait photo of gareth person, portrait, happy colors, bright eyes, clear eyes, warm smile, smooth soft skin, big dreamy eyes, beautiful intricate colored hair, symmetrical, anime wide eyes, soft lighting, detailed face, by makoto shinkai, stanley artgerm lau, wlop, rossdraws, concept art, digital painting, looking into camera",
  "width": "512",
  "height": "512",
  "samples": "1",
  "num_inference_steps": "30",
  "safety_checker": "no",
  "enhance_prompt": "yes",
  "seed": null,
  "guidance_scale": 7.5,
  "self_attention": "no",
  "vae": null,
  "webhook": null,
  "track_id": null
});

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

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

Response​

{
  "status": "success",
  "generationTime": 14.079592943191528,
  "id": 13441520,
  "output": [
    "https://pub-8b49af329fae499aa563997f5d4068a4.r2.dev/generations/4118bb93-2c49-4d1d-9837-f43a0801e42e-0.png"
  ],
  "meta": {
    "prompt": "mdjrny-v4 style actual 8K portrait photo of gareth person, portrait, happy colors, bright eyes, clear eyes, warm smile, smooth soft skin, big dreamy eyes, beautiful intricate colored hair, symmetrical, anime wide eyes, soft lighting, detailed face, by makoto shinkai, stanley artgerm lau, wlop, rossdraws, concept art, digital painting, looking into camera DSLR photography, sharp focus, Unreal Engine 5, Octane Render, Redshift, ((cinematic lighting)), f/1.4, ISO 200, 1/160s, 8K, RAW, unedited, symmetrical balance, in-frame",
    "model_id": "midjourney",
    "scheduler": "DDPMScheduler",
    "safetychecker": "no",
    "W": 512,
    "H": 512,
    "guidance_scale": 7.5,
    "seed": 3292243727,
    "steps": 20,
    "n_samples": 1,
    "full_url": "no",
    "panorama": "no",
    "self_attention": "no",
    "outdir": "out",
    "file_prefix": "4118bb93-2c49-4d1d-9837-f43a0801e42e"
  }
}