---
title: "画像・動画のアップロード"
description: "画像または動画をアップロードしてメディア ID を取得します。メディア ID は保存されたファイルを識別します。"
canonical: "https://platform.pixai.art/ja/docs/api/media/uploadMedia"
last-updated: "2026-11-02"
---

# 画像・動画のアップロード

画像または動画をアップロードしてメディア ID を取得します。メディア ID は保存されたファイルを識別します。



## POST https://api.pixai.art/v1/media/upload

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

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

### Request body (`image/png`)

### Request body (`image/jpeg`)

### Request body (`image/webp`)

### Request body (`image/gif`)

### Request body (`video/mp4`)

### Example (cURL)

```bash
curl -X POST https://api.pixai.art/v1/media/upload \
  -H "Authorization: Bearer $PIXAI_API_KEY" \
  -H "Content-Type: image/png" \
  --data-binary @reference.png
```

### Responses

- `200`
  アップロードされたメディア。
  Body fields:
  - `id` (string, required)
    メディアの一意な識別子。他のメディアエンドポイントの `mediaId` パスパラメーターにこの値を使用します。
  - `type` (string, required)
    サーバーが判定したメディアタイプ。
    Allowed values: `IMAGE`, `VIDEO`.
  - `urls` (object[], optional)
    メディアの利用可能な URL。画像のアップロードではこのフィールドが返ります。
  - `urls[].variant` (string, required)
    URL のバリアント。
    Allowed values: `PUBLIC`, `THUMBNAIL`, `STILL_THUMBNAIL`.
  - `urls[].url` (string, required)
  - `width` (integer, optional)
    画像の幅（ピクセル）。
  - `height` (integer, optional)
    画像の高さ（ピクセル）。
  - `imageType` (string, optional)
    保存された画像の MIME タイプ（例: `image/png`）。
  - `fileUrl` (string, optional)
    ファイル URL。動画のアップロードではこのフィールドが返ります。
  - `duration` (number, optional)
    長さ（秒）。動画のアップロードではこのフィールドが返ります。
  - `thumbnailUrl` (string, optional)
    サムネイル URL。動画のアップロードではこのフィールドが返ります。
  - `hlsUrl` (string, optional)
    HLS プレイリスト URL。動画のアップロードではこのフィールドが返ります。
  - `size` (integer, optional)
    ファイルサイズ（バイト）。動画のアップロードではこのフィールドが返ります。
- `400`
  `Content-Type` ヘッダーがない、`Content-Length` ヘッダーがない、ボディ長が `Content-Length` と一致しない、またはコンテンツタイプが画像でも動画でもありません。
- `401`
  API キーがないか、無効です。