---
title: "Request custom prompt image generation"
method: POST
path: "/v1/studio/custom-image"
tags: ["Studio"]
---

# Request custom prompt image generation

`POST /v1/studio/custom-image`

Generates image(s) for the specified character using a custom text prompt. The prompt is composed with model-specific styling before generation.

## Request body

- StudioRequestCustomImageDto
  - `modelId` string, required — Model (AI partner) ID
  - `prompt` string, required — Custom prompt for image generation
  - `count` number — Number of images to generate (1-10)

## Response `201`

Custom image generation started successfully

- StudioGenerationResponseDto
  - `id` string, required — Attachment ID
  - `type` 'image' | 'video' | 'audio' | 'gift', required — Type of media
  - `status` 'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'TIMED_OUT', required — Status of the media generation
  - `modelId` string, required — Model ID associated with this generation
  - `createdAt` string, date-time, required — Creation timestamp

## Other responses

- `402` — Insufficient coin balance
- `403` — User does not have access to this model or subscription required
- `404` — Model not found

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)