---
title: "업로드한 오디오 파일 등록"
description: "오디오 클립 업로드의 3단계입니다. 반환된 id가 referenceAudioMediaIds에 전달할 미디어 ID입니다."
canonical: "https://platform.pixai.art/ko/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.ko.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}`이 반환됩니다.