---
title: "Upscale an existing image or video attachment"
method: POST
path: "/v1/studio/upscale"
tags: ["Studio"]
---

# Upscale an existing image or video attachment

`POST /v1/studio/upscale`

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

## Request body

- StudioUpscaleAttachmentDto
  - `attachmentId` string, required — Attachment ID of the image or video to upscale

## Response `201`

Upscale 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 completed image/video, or subscription required (upscaling 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)