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

# Request custom prompt video generation

`POST /v1/studio/custom-video`

Generates video for the specified character using a custom text prompt. First generates an image, then converts to video.

## Request body

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

## Response `201`

Custom video 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)