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

# Request studio video generation

`POST /v1/studio/video`

Generates video for the specified character. First generates an image, then converts to video. Returns immediately with generation status.

## Request body

- StudioRequestVideoDto
  - `modelId` string, required — Model (AI partner) ID
  - `surroundingsId` number, required — Surroundings id
  - `clothesId` number, required — Clothes id
  - `emotionsId` number, required — Emotions id
  - `posesId` number, required — Poses id
  - `count` number — Number of videos to generate (1-10)

## Response `201`

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 (studio generation is only available to subscribers)
- `404` — Model or preset parameters 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)