---
title: "동영상·오디오 파일 정보 조회"
description: "동영상 또는 오디오 미디어 항목의 길이, 크기, 컨테이너, 코덱을 반환합니다. 참조 동영상 작업을 생성하기 전에 참조 파일이 모델의 제한을 충족하는지 확인할 수 있습니다."
canonical: "https://platform.pixai.art/ko/docs/api-v2/media/getMediaInfo"
last-updated: "2026-11-02"
---

# 동영상·오디오 파일 정보 조회

동영상 또는 오디오 미디어 항목의 길이, 크기, 컨테이너, 코덱을 반환합니다. 참조 동영상 작업을 생성하기 전에 참조 파일이 모델의 제한을 충족하는지 확인할 수 있습니다.



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

Authentication: send your API key as `Authorization: Bearer <API key>`.

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

### Parameters

- `mediaId` (in path, string, required)
  동영상 또는 오디오 미디어 ID입니다.

### Responses

- `200`
  미디어 메타데이터.
  Body fields:
  - `mediaId` (string, optional)
  - `durationSeconds` (number | null, optional)
    길이(초).
  - `sizeBytes` (string | null, optional)
    크기(바이트, 10진수 문자열).
  - `containers` (string[], optional)
    컨테이너 형식(소문자, `mp3`, `mov` 등)입니다.
  - `videoStreams` (object[], optional)
    동영상 스트림마다 하나의 항목입니다.
  - `videoStreams[].codec` (string, optional)
  - `videoStreams[].width` (integer, optional)
  - `videoStreams[].height` (integer, optional)
  - `videoStreams[].averageFrameRate` (number, optional)
  - `audioStreams` (object[], optional)
    오디오 스트림마다 하나의 항목입니다.
  - `audioStreams[].codec` (string, optional)
- `400`
  `NOT_VIDEO_OR_AUDIO`: 이미지 미디어입니다.
- `401`
  `UNAUTHORIZED`: API 키를 보내지 않았습니다. 잘못되었거나 폐기되었거나 만료된 키에는 숫자 `code`를 가진 `{"message": "invalid token", "code": 40100001}`이 반환됩니다.
- `404`
  `MEDIA_NOT_FOUND`: 이 ID의 미디어가 없습니다.