---
title: "base64 で渡した画像を素材に登録する"
method: POST
path: "/api/v1/assets/image-uploads/inline"
tags: ["assets"]
---

# base64 で渡した画像を素材に登録する

`POST /api/v1/assets/image-uploads/inline`

## Request

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

## Request body

- object
  - `dataBase64` string, required: 画像ファイルの中身の base64（data:image/png;base64, の前置き・改行・base64url の文字は許す）。デコード後 8MB まで
  - `fileName` string: ファイル名（省略可）
  - `mimeType` 'image/png' | 'image/jpeg' | 'image/webp': 形式（省略可。省略すると中身から判定。書くなら中身と一致させる）
  - `kind` 'material' | 'background': material（行ごとの素材画像）/ background（動画全体・場面の背景）

## Response `200`

登録した画像

- RegisteredImage: image-uploads/confirm と image-uploads/inline の 200。url は POST /api/v1/assets/import の results[].url と同じ扱い
  - `data` object
    - `ok` boolean
    - `url` string: materialImageUrl / backgroundImageUrl にそのまま書ける永続 URL
    - `assetId` string
    - `key` string
    - `kind` 'material' | 'background'
    - `mimeType` 'image/png' | 'image/jpeg' | 'image/webp': 中身から判定した形式
    - `fileSizeBytes` integer
    - `alreadyRegistered` boolean: 確定済みの key をもう一度確定した（使用量は増えていない）

## Other responses

- `400`: リクエスト不正（code: validation_error。base64 として読めない・8MB を超える・中身が png / jpeg / webp でない・mimeType と中身が一致しない）
- `401`: 認証エラー（code: unauthenticated）
- `403`: スコープ不足（code: insufficient_scope。projects:write が必要）
- `429`: レート上限（code: rate_limited）またはストレージ容量の上限（code: quota_exceeded。current と limit が付く）
- `500`: 保存・登録に失敗（code: internal_error）。押さえた容量は外してある

---

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