---
title: "動画・音声ファイルの情報の取得"
description: "動画または音声のメディアアイテムの長さ、サイズ、コンテナ、コーデックを返します。参照動画タスクを作成する前に、参照ファイルがモデルの制限を満たしているか確認できます。"
canonical: "https://platform.pixai.art/ja/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.ja.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)
    動画ストリームごとに 1 要素です。
  - `videoStreams[].codec` (string, optional)
  - `videoStreams[].width` (integer, optional)
  - `videoStreams[].height` (integer, optional)
  - `videoStreams[].averageFrameRate` (number, optional)
  - `audioStreams` (object[], optional)
    音声ストリームごとに 1 要素です。
  - `audioStreams[].codec` (string, optional)
- `400`
  `NOT_VIDEO_OR_AUDIO`: メディアが画像です。
- `401`
  `UNAUTHORIZED`: API キーが送られていません。無効、失効済み、期限切れのキーの場合は、数値の `code` を持つ `{"message": "invalid token", "code": 40100001}` が返ります。
- `404`
  `MEDIA_NOT_FOUND`: この ID のメディアは存在しません。