Instant Character

InstantCharacter creates high-quality, consistent characters from text prompts, supporting diverse poses, styles, and appearances with strong identity control.

Features

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v2/wavespeed-ai/instant-character" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "prompt": "A futuristic android girl with glowing blue eyes, wearing green suit, standing next to a holographic sign displaying \"I Love WaveSpeedAI\", neon-lit cyberpunk city background, sleek and high-tech vibe, Sci-fi movie style",
    "image": "https://d2g64w682n9w0w.cloudfront.net/media/images/1745853771145444122_WW40XTQM.jpg",
    "size": "1024*1024",
    "negative_prompt": "",
    "guidance_scale": 3.5,
    "num_inference_steps": 28,
    "num_images": 1,
    "enable_safety_checker": true
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v2/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

Parameter	Type	Required	Default	Range	Description
prompt	string	Yes	A futuristic android girl with glowing blue eyes, wearing green suit, standing next to a holographic sign displaying "I Love WaveSpeedAI", neon-lit cyberpunk city background, sleek and high-tech vibe, Sci-fi movie style	-	The prompt to generate an image from.
image	string	Yes	https://d2g64w682n9w0w.cloudfront.net/media/images/1745853771145444122_WW40XTQM.jpg	-	The image URL to generate an image from. Needs to match the dimensions of the mask.
size	string	No	1024*1024	512 ~ 1536 per dimension	The size of the generated image.
negative_prompt	string	No	-	-	The negative prompt to use. Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small details (e.g. moustache, blurry, low resolution).
seed	integer	No	-	-1 ~ 9999999999	The same seed and the same prompt given to the same version of the model will output the same image every time.
guidance_scale	number	No	3.5	0 ~ 20	The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you.
num_inference_steps	integer	No	28	1 ~ 50	The number of inference steps to perform.
num_images	integer	No	1	1 ~ 4	The number of images to generate.
enable_safety_checker	boolean	No	true	-	If set to true, the safety checker will be enabled.

Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data.id	string	Unique identifier for the prediction, Task Id
data.model	string	Model ID used for the prediction
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Result Query Parameters

Result Request Parameters

Parameter	Type	Required	Default	Description
id	string	Yes	-	Task ID

Result Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data	object	The prediction data object containing all details
data.id	string	Unique identifier for the prediction
data.model	string	Model ID used for the prediction
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Step1x Edit Meta