---
title: "音声ファイルのアップロード URL の取得"
description: "POST /v2/reference-video/create の referenceAudioMediaIds に使う音声クリップをアップロードする手順のステップ 1 です。流れは画像と同じです。ファイルの Content-Type（audio/mpeg または audio/wav）を付けてバイトを uploadUrl に PUT し、その後 POST /v2/media/audio/register を呼び出します。"
canonical: "https://platform.pixai.art/ja/docs/api-v2/media/getAudioUploadUrl"
last-updated: "2026-11-02"
---

# 音声ファイルのアップロード URL の取得

`POST /v2/reference-video/create` の `referenceAudioMediaIds` に使う音声クリップをアップロードする手順のステップ 1 です。流れは画像と同じです。ファイルの `Content-Type`（`audio/mpeg` または `audio/wav`）を付けてバイトを `uploadUrl` に `PUT` し、その後 `POST /v2/media/audio/register` を呼び出します。



受け付けるのは WAV と MP3 のみで、1 クリップあたり 15 MiB 未満です。長さの制限は動画モデルによって異なり、アップロード時ではなく動画タスクの作成時にチェックされます。

## POST https://api.pixai.art/v2/media/audio/upload-url

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

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

### Request body (`application/json`)

- `isEphemeral` (boolean, optional)
  ファイルを短期間だけ使う生成入力としてマークします。エフェメラルファイルは非公開で、その URL は署名付きで有効期限があります。
  Default: `false`.

Example:

```json
{}
```

### Responses

- `200`
  アップロード先。
  Body fields:
  - `uploadUrl` (string, required)
    署名付き URL です。ファイルの `Content-Type` を付けて、生のファイルバイトを `PUT` してください。
  - `externalId` (string, required)
    アップロード後、対応する `register` エンドポイントにこの値を渡してください。
- `401`
  `UNAUTHORIZED`: API キーが送られていません。無効、失効済み、期限切れのキーの場合は、数値の `code` を持つ `{"message": "invalid token", "code": 40100001}` が返ります。