---
title: "Get media URLs by ID"
description: "Resolves up to 100 media IDs to their URLs, for example the outputs.mediaIds or outputs.videoMediaId of a finished task. No authentication is needed for public media."
canonical: "https://platform.pixai.art/en/docs/api-v2/media/batchGetMedia"
last-updated: "2026-11-02"
---

# Get media URLs by ID

Resolves up to 100 media IDs to their URLs, for example the `outputs.mediaIds` or `outputs.videoMediaId` of a finished task. No authentication is needed for public media.



IDs that do not exist are left out, and the order of the result is not guaranteed, so match items by `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.yaml

### Parameters

- `ids` (in query, object (one of the variants below), required)
  Comma-separated media IDs, 1 to 100, e.g. `?ids=1,2,3`. Repeating the parameter (`?ids=1&ids=2`) also works.

### Responses

- `200`
  The media items found.
  Body fields: