---
title: "S3 への直接アップロード用 pre-signed URL を発行する"
method: POST
path: "/api/v1/assets/upload-url"
tags: ["assets"]
---

# S3 への直接アップロード用 pre-signed URL を発行する

`POST /api/v1/assets/upload-url`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/assets/upload-url`
- Auth: HTTP bearer

## Request body

- object
  - `fileName` string, required
  - `mimeType` string, required
  - `fileSize` integer, required: バイト数（正の整数）
  - `assetType` 'character' | 'background' | 'background-video' | 'bgm' | 'sfx' | 'overlay' | 'thumbnail-element' | 'material', required

## Response `200`

pre-signed URL の発行成功

- object
  - `data` object
    - `uploadUrl` string, uri
    - `key` string
    - `fileUrl` string, uri

## Other responses

- `400`: リクエスト不正（code: validation_error）
- `401`: 未認証
- `403`: 権限不足

---

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