Sign in
Images

Generate Image (Async)

Generate an image of the character. This is an asynchronous operation — submit the request, receive a job_id and presigned_url, then poll GET /api/v1/jobs/{job_id}/status until the job completes. The presigned_url will contain the generated image once the job status is "completed".

post/api/v1/images

Request body

character_idstring required

Character identifier for generation

promptstring required

Description of the image to generate

prompt_enhancementboolean

When enabled, the system enhances your prompt using AI to improve image quality and detail. When disabled, your prompt is used as-is.

user_gender'male' | 'female'

Gender of the user. Used to tailor the generated scene when prompt enhancement is enabled. If omitted, defaults to the opposite of the character's gender.

Response

Image generation job accepted

messagestring

Status message

job_idstring

Unique identifier for tracking job status

statusstring

Current status (processing, completed, failed)

presigned_urlstring

S3 presigned URL where the image will be available

Changes