---
title: "アップロードした音声ファイルの登録"
description: "音声クリップのアップロードのステップ 3 です。返される id が、referenceAudioMediaIds に渡すメディア ID です。"
canonical: "https://platform.pixai.art/ja/docs/api-v2/media/registerAudio"
last-updated: "2026-11-02"
---

# アップロードした音声ファイルの登録

音声クリップのアップロードのステップ 3 です。返される `id` が、`referenceAudioMediaIds` に渡すメディア ID です。



## POST https://api.pixai.art/v2/media/audio/register

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`)

- `externalId` (string, required)
  `POST /v2/media/audio/upload-url` で返された `externalId` です。

Example:

```json
{
  "externalId": "3f2b8c1e-6a4d-4f6e-9b1a-2c7d5e8f9a01"
}
```

### Responses

- `200`
  登録された音声ファイル。
  Body fields:
  - `id` (string, required)
    メディア ID です。
  - `fileUrl` (string | null, optional)
    ファイルの URL です。
  - `duration` (number | null, optional)
    長さ（秒）です。
  - `size` (number | null, optional)
    サイズ（バイト）です。
  - `codec` (string | null, optional)
- `401`
  `UNAUTHORIZED`: API キーが送られていません。無効、失効済み、期限切れのキーの場合は、数値の `code` を持つ `{"message": "invalid token", "code": 40100001}` が返ります。