---
title: "PUT し終えた音を確かめて素材に登録する"
method: POST
path: "/api/v1/assets/audio-uploads/confirm"
tags: ["assets"]
---

# PUT し終えた音を確かめて素材に登録する

`POST /api/v1/assets/audio-uploads/confirm`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/assets/audio-uploads/confirm`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Request body

- object
  - `key` string, required: audio-uploads が返した key（users/... で始まる）
  - `name` string: 素材の名前（省略するとキーのファイル名）

## Response `200`

登録した（または確定済みだった）

- RegisteredAudio: audio-uploads/confirm と audio-uploads/inline の 200。url を行の bgm / effect にそのまま書ける
  - `data` object
    - `ok` boolean
    - `url` string: 行の bgm / effect にそのまま書ける永続 URL
    - `assetId` string
    - `key` string
    - `kind` 'bgm' | 'sfx'
    - `mimeType` 'audio/mpeg' | 'audio/wav' | 'audio/ogg': 中身から判定した形式
    - `fileSizeBytes` integer
    - `alreadyRegistered` boolean: 確定済みの key をもう一度確定した（使用量は増えていない）

## Other responses

- `400`: 中身が mp3 / wav / ogg でない・Content-Type と中身が違う・大きさが範囲外・key が音の置き場所でない（code: validation_error。置かれたファイルは消してある）
- `401`: 認証エラー（code: unauthenticated）
- `403`: 他人の key（code: forbidden）・スコープ不足（code: insufficient_scope。projects:write が必要）
- `404`: 置かれていない（code: not_found。PUT がまだ・失敗した・URL の期限切れ）
- `429`: レート上限（code: rate_limited）
- `500`: 処理に失敗した（code: internal_error）

## Changes

- **2026-10-20** `ba5f36b016da`: 30 warning, 18 info
  - added the new `already_subscribed` enum value to the `code` response property for the response status `400`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `401`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `403`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `404`
  - …44 more

[Operation history](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/changes/api/v1/assets/audio-uploads/confirm/post.md)

---

[API](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api.md) · [All operations](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/revisions/ba5f36b016da?raw)