---
title: "プロジェクトのサムネイルを生成・更新する"
method: POST
path: "/api/v1/projects/{projectId}/thumbnail"
tags: ["projects"]
---

# プロジェクトのサムネイルを生成・更新する

`POST /api/v1/projects/{projectId}/thumbnail`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/projects/{projectId}/thumbnail`
- Auth: HTTP bearer

## Path parameters

- `projectId` string, required

## Request body

- object
  - `thumbnailText` string
  - `characterLeftImageUrl` string
  - `characterRightImageUrl` string
  - `character_left_label` string
  - `character_right_label` string
  - `titleLine1` string
  - `titleLine2` string
  - `leftBubble` string
  - `rightBubble` string
  - `imagegen` object
    - `leftImageUrl` string
    - `rightImageUrl` string
    - `leftLabel` string
    - `rightLabel` string
  - `imageReplacements` object: レイヤー名 → 画像URLのマップ

## Response `200`

生成成功

- object
  - `thumbnailUrl` string
  - `thumbnailText` string
  - `thumbnailTemplateId` string
  - `imagegenImagesApplied` boolean

## Other responses

- `401`: 未認証
- `403`: 権限不足
- `404`: プロジェクトが見つからない（code: not_found）

---

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