---
title: "ID로 미디어 URL 조회"
description: "완료된 작업의 outputs.mediaIds나 outputs.videoMediaId 등 최대 100개의 미디어 ID를 URL로 변환합니다. 공개 미디어는 인증이 필요하지 않습니다."
canonical: "https://platform.pixai.art/ko/docs/api-v2/media/batchGetMedia"
last-updated: "2026-11-02"
---

# ID로 미디어 URL 조회

완료된 작업의 `outputs.mediaIds`나 `outputs.videoMediaId` 등 최대 100개의 미디어 ID를 URL로 변환합니다. 공개 미디어는 인증이 필요하지 않습니다.



존재하지 않는 ID는 결과에서 제외되며 결과 순서는 보장되지 않으므로, `id`로 항목을 대조하세요.

## GET https://api.pixai.art/v2/media/batch

Authentication: optional. Send your API key as `Authorization: Bearer <API key>` to read as your account.

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

### Parameters

- `ids` (in query, object (one of the variants below), required)
  쉼표로 구분한 미디어 ID 1~100개입니다(예: `?ids=1,2,3`). 파라미터를 반복(`?ids=1&ids=2`)해도 됩니다.

### Responses

- `200`
  조회된 미디어 항목.
  Body fields: