---
title: "Generate a character image (async job)"
method: POST
path: "/v1/studio/series/{seriesId}/characters/{characterId}/image-assets/generate"
tags: ["Studio"]
---

# Generate a character image (async job)

`POST /v1/studio/series/{seriesId}/characters/{characterId}/image-assets/generate`

## Request

- Base URL: `https://api.lizzflix.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lizzflix.xyz/v1/studio/series/{seriesId}/characters/{characterId}/image-assets/generate`
- Auth: none declared

## Path parameters

- `seriesId` string, required
- `characterId` string, required

## Request body

- EntityImageGenerateBody
  - `generationPrompt` string, required: What to generate.
  - `selectedImageModelId` string, required: Image model key (GET /v1/catalog/models).
  - `references` ReferenceHandle[]: Reference images, in order (prompts address them as image 1, 2...). How many a model takes is in GET /v1/studio/reference-limits; more or fewer is a 400 (reason reference_limit_exceeded / reference_required), never trimmed. References are free.
  - `label` string
  - `tags` string[]
  - `referenceImageUrls` string[]: Links to your own images (`/api/v1/assets/{id}/content`). Use `references`.

## Response `202`

Image generation job accepted

- StudioGenerationJobAcceptedResponse
  - `job` StudioJob, nullable, required
    - `id` string, required
    - `jobType` string, nullable
    - `status` string, required
    - `queueMode` string
    - `sceneId` string, nullable
    - `provider` string, nullable
    - `model` string
    - `modelKey` string
    - `operation` string
    - `providerJobId` string, nullable
    - `attempt` number
    - `pollAfter` string, nullable
    - `request` object
    - `result` object, nullable
    - `errorMessage` string, nullable
    - `error` object, nullable
    - `createdAt` string
    - `updatedAt` string
    - `completedAt` string, nullable
    - `assets` object[]

## Other responses

- `400`: Invalid body or references (`reason`)
- `401`: Unauthorized
- `404`: Character or a reference not found

---

[API](https://skmtc.dev/lizzflix/apis/lizzflix-api.md) · [All operations](https://skmtc.dev/lizzflix/apis/lizzflix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lizzflix/apis/lizzflix-api/revisions/4536ce9d80ff?raw)