Consistent Character V1

Create images of a given character in different poses

~40.85s
~$0.129
 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/consistent-character-ai-neolemon"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "prompt": "((masterpiece, best quality, highly detailed)), simple background, character sheet, multiple poses, multiple actions, visible face, (one person), portrait, full body, young african american girl, white sweater, jeans, short curly brown hair, 2D illustration style",
12    "negative_prompt": "text, watermark, underexposed, ugly, jpeg, (worst quality, low quality, lowres, low details, oversaturated, undersaturated, overexposed, grayscale, bw, bad photo, bad art:1.4), (font, username, error, logo, words, letters, digits, autograph, trademark, name:1.2), (blur, blurry, grainy), cropped, out of frame, cut off, jpeg artifacts, out of focus, glitch, duplicate, (amateur:1.3), merging, clipping, (nsfw), multiple hands, mutant, glitch, uncanny, cross eye, broken face, astronaut, helmet, blurry,",
13    "image": "https://segmind-sd-models.s3.amazonaws.com/display_images/testing_imgs/ref.pose.png",
14    "num_inference_steps": 20,
15    "guidance_scale": 7,
16    "seed": 4898558797,
17    "samples": 1,
18    "strength": 0.8,
19    "scheduler": "karras",
20    "sampler": "dpmpp_2m",
21    "upscale_by": 2,
22    "upscale_steps": 20,
23    "upscale_guidance_scale": 7,
24    "upscale_scheduler": "karras",
25    "upscale_sampler": "dpmpp_2m",
26    "upscale_mode_type": "Linear",
27    "fd_steps": 20,
28    "fd_guidance_scale": 7,
29    "fd_scheduler": "karras",
30    "fd_sampler": "dpmpp_2m"
31}
32
33response = requests.post(url, headers=headers, json=data)
34
35if response.status_code == 200:
36    result = response.json()
37    print(json.dumps(result, indent=2))
38else:
39    print(f"Error: {response.status_code}")
40    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/consistent-character-ai-neolemon

Parameters

fd_guidance_scalerequired
number

Guidance scale for face detection

Default: 7Range: 1 - 20
fd_samplerrequired
string

Sampler type for face detection

Default: "dpmpp_2m"
Allowed values (26 total):
"euler""euler_pp""euler_ancestral""euler_ancestral_pp""heun""heunpp2""dpm_2""dpm_2_ancestral""lms""dpm_fast"+16 more
fd_schedulerrequired
string

Scheduler type for face detection

Default: "karras"
Allowed values :
"normal""karras""exponential""sgm_uniform""simple""ddim_uniform"
fd_stepsrequired
integer

Number of steps for face detection

Default: 20Range: 1 - 100
guidance_scalerequired
number

Guidance scale for image generation

Default: 7Range: 1 - 20
imagerequired
string (uri)

URL of the input image

Default: "https://segmind-sd-models.s3.amazonaws.com/display_images/testing_imgs/ref.pose.png"
num_inference_stepsrequired
integer

Number of steps for inference

Default: 20Range: 1 - 100
promptrequired
string

Text prompt for image generation

Default: "((masterpiece, best quality, highly detailed)), simple background, character sheet, multiple poses, multiple actions, visible face, (one person), portrait, full body,young african american girl, white sweater, jeans, short curly brown hair, 2D illustration style"
samplerrequired
string

Sampler type for image generation

Default: "dpmpp_2m"
Allowed values (26 total):
"euler""euler_pp""euler_ancestral""euler_ancestral_pp""heun""heunpp2""dpm_2""dpm_2_ancestral""lms""dpm_fast"+16 more
samplesrequired
integer

Number of samples to generate

Default: 1
schedulerrequired
string

Scheduler type for image generation

Default: "karras"
Allowed values :
"normal""karras""exponential""sgm_uniform""simple""ddim_uniform"
seedrequired
integer

Seed for random number generation

Default: 4898558797
strengthrequired
number

Strength of image generation

Default: 0.8Range: 0 - 1
upscale_byrequired
integer

Upscale factor for the image

Default: 2Range: 1 - 4
upscale_guidance_scalerequired
number

Guidance scale for upscaling

Default: 7Range: 1 - 20
upscale_mode_typerequired
string

Mode type for upscaling

Default: "Linear"
Allowed values :
"Linear""Bicubic""Lanczos"
upscale_samplerrequired
string

Sampler type for upscaling

Default: "dpmpp_2m"
Allowed values (26 total):
"euler""euler_pp""euler_ancestral""euler_ancestral_pp""heun""heunpp2""dpm_2""dpm_2_ancestral""lms""dpm_fast"+16 more
upscale_schedulerrequired
string

Scheduler type for upscaling

Default: "karras"
Allowed values :
"normal""karras""exponential""sgm_uniform""simple""ddim_uniform"
upscale_stepsrequired
integer

Number of steps for upscaling

Default: 20Range: 1 - 100
negative_promptoptional
string

Negative prompt to avoid certain elements

Default: "text, watermark, underexposed, ugly, jpeg, (worst quality, low quality, lowres, low details, oversaturated, undersaturated, overexposed, grayscale, bw, bad photo, bad art:1.4), (font, username, error, logo, words, letters, digits, autograph, trademark, name:1.2), (blur, blurry, grainy), cropped, out of frame, cut off, jpeg artifacts, out of focus, glitch, duplicate, (amateur:1.3), merging, clipping, (nsfw), multiple hands, mutant, glitch, uncanny, cross eye, broken face, astronaut, helmet, blurry,"

Response Type

Returns: Image

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out