---
title: "Generate Image (Async)"
method: POST
path: "/api/v1/images"
tags: ["Images"]
---

# Generate Image (Async)

`POST /api/v1/images`

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".

## Request body

- object
  - `character_id` string, required — Character identifier for generation
  - `prompt` string, required — Description of the image to generate
  - `prompt_enhancement` boolean — 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.
  - `resolution` union — Output resolution. Can be an aspect ratio string ("9:16", "16:9", "1:1", "4:3", "3:4") or an explicit [width, height] array. Aspect ratio presets map to: 9:16 → 720×1280, 16:9 → 1280×720, 1:1 → 1024×1024, 4:3 → 960×720, 3:4 → 720×960.
    - integer[] — Explicit [width, height] in pixels
    - '9:16' | '16:9' | '1:1' | '4:3' | '3:4' — Aspect ratio preset

## Response `202`

Image generation job accepted

- object
  - `message` string — Status message
  - `job_id` string — Unique identifier for tracking job status
  - `status` string — Current status (processing, completed, failed)
  - `presigned_url` string — S3 presigned URL where the image will be available

---

[API](https://skmtc.dev/oh/apis/ohapi-documentation.md) · [All operations](https://skmtc.dev/oh/apis/ohapi-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oh/ohapi-documentation/revisions/b623c2e9cb65/schema)