---
title: "Animate an existing image to video"
method: POST
path: "/v1/studio/animate"
tags: ["Studio"]
---

# Animate an existing image to video

`POST /v1/studio/animate`

Takes an existing image attachment and generates a video from it. Returns immediately with generation status.

## Request body

- StudioAnimateImageDto
  - `attachmentId` string, required — Attachment ID of the image to animate
  - `promptOverride` string — Optional prompt override for the animation

## Response `201`

Animation 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 attachment, attachment is not a valid image, or subscription required (video generation is only available to subscribers)
- `404` — Attachment 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)