Enterprise: Text to Image Endpoint

Overview

This endpoint generates an image from a text prompt in realtime.

caution

Make sure you add your s3 details for realtime server, so you can receive image generated in your bucket. Images generated without s3 details being added will be delete after 24hours

Request

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

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

Body Attributes

Parameter	Description
key	Your API Key used for request authorization.
prompt	Text prompt with description of the things you want in the image to be generated.
negative_prompt	Items you don't want in the image.
width	Max Height: Width: 1024x1024.
height	Max Height: Width: 1024x1024.
samples	Number of images to be returned in response. The maximum value is 4.
safety_checker	A checker for NSFW images. If such an image is detected, it will be replaced by a blank image.
seed	Seed is used to reproduce results, same seed will give you same image in return again. Pass null for a random number.
instant_response	queue response instantly before processing finishes instead of waiting a minimum amount of time default: false, options: true or false
base64	Get response as base64 string, default: false, options: true or false
webhook	Set an URL to get a POST API call once the image generation is complete.
track_id	This ID is returned in the response to the webhook API call. This will be used to identify the webhook request.
enhance_prompt	Enhance prompts for better results; options: true or false.
enhance_style	This 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

JS

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/v1/enterprise/realtime/text2img", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

PHP

<?php

$payload = [
    "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
];

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://modelslab.com/api/v1/enterprise/realtime/text2img',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode($payload),
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

NODE

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://modelslab.com/api/v1/enterprise/realtime/text2img',
  'headers': {
    'Content-Type': 'application/json'
  },
  body: 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
  })
};

request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

PYTHON

import requests
import json

url = "https://modelslab.com/api/v1/enterprise/realtime/text2img"

payload = json.dumps({
     "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": None,
    "samples":1,
    "base64":False,
    "webhook": None,
    "track_id": None
})

headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

JAVA

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"key\":\"\",\n  \"prompt\": \"Black african wearing a suit in a corporate meeting\",\n  \"negative_prompt\": \"bad quality\",\n  \"width\": \"512\",\n  \"height\": \"512\",\n   \"safety_checker\": false,\n  \"seed\": 2345,\n  \"sample\":1,\n  \"webhook\": \"\",\n  \"track_id\": 20\n}");
Request request = new Request.Builder()
  .url("https://modelslab.com/api/v1/enterprise/realtime/text2img")
  .method("POST", body)
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

Response

{
  "status": "success",
  "generationTime": 1.3200268745422363,
  "id": 12202888,
  "output": [
    "https://pub-8b49af329fae499aa563997f5d4068a4.r2.dev/generations/e5cd86d3-7305-47fc-82c1-7d1a3b130fa4-0.png"
  ],
  "meta": {
    "H": 512,
    "W": 512,
    "enable_attention_slicing": "true",
    "file_prefix": "e5cd86d3-7305-47fc-82c1-7d1a3b130fa4",
    "guidance_scale": 7.5,
    "model": "runwayml/stable-diffusion-v1-5",
    "n_samples": 1,
    "negative_prompt": " ((out of frame)), ((extra fingers)), mutated hands, ((poorly drawn hands)), ((poorly drawn face)), (((mutation))), (((deformed))), (((tiling))), ((naked)), ((tile)), ((fleshpile)), ((ugly)), (((abstract))), blurry, ((bad anatomy)), ((bad proportions)), ((extra limbs)), cloned face, glitchy, ((extra breasts)), ((double torso)), ((extra arms)), ((extra hands)), ((mangled fingers)), ((missing breasts)), (missing lips), ((ugly face)), ((fat)), ((extra legs))",
    "outdir": "out",
    "prompt": "ultra realistic close up portrait ((beautiful pale cyberpunk female with heavy black eyeliner)) 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",
    "revision": "fp16",
    "safetychecker": "no",
    "seed": 3499575229,
    "steps": 20,
    "vae": "stabilityai/sd-vae-ft-mse"
  }
}