---
title: "ID로 미디어 조회"
description: "ID로 미디어를 조회하여 유형, 크기 및 각 변형(variant)의 URL을 확인합니다."
canonical: "https://platform.pixai.art/ko/docs/api/media/getMedia"
last-updated: "2026-11-02"
---

# ID로 미디어 조회

ID로 미디어를 조회하여 유형, 크기 및 각 변형(variant)의 URL을 확인합니다.



## GET https://api.pixai.art/v1/media/{mediaId}

Machine-readable OpenAPI spec: https://platform.pixai.art/openapi-spec.ko.yaml

### Parameters

- `mediaId` (in path, string, required)
  조회할 미디어 ID

### Responses

- `200`
  성공
  Body fields:
  - `id` (string, required)
    미디어의 고유 식별자
  - `type` (string, required)
  - `urls` (object[], required)
  - `urls[].variant` (string, required)
  - `urls[].url` (string, required)
  - `width` (integer, optional)
    미디어의 너비.
  - `height` (integer, optional)
    미디어의 높이.
- `404`
  미디어를 찾을 수 없음