---
title: "テンプレートの見た目を読む"
method: GET
path: "/api/v1/agent/templates/{templateId}/style"
tags: ["agent"]
---

# テンプレートの見た目を読む

`GET /api/v1/agent/templates/{templateId}/style`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/agent/templates/{templateId}/style`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `templateId` string, required

## Response `200`

見た目

- object
  - `templateId` string, required
  - `source` 'system' | 'mine' | 'shared'
  - `basedOn` string, nullable
  - `name` string
  - `style` TemplateStyle, required: テンプレートの見た目（描かれている値）。描き手は元の組み込みで決まる: yukkuri-talk / tohoku-ahiru-talk を元にしたものはその組み込み、それ以外（白紙・ほかの組み込みの複製）は UserTemplate。unsupported はそのテンプレートでは描かれない項目
    - `subtitle` object, required
      - `look` 'bold' | 'box' | 'box-outline' | 'box-speaker-outline' | 'frame', nullable: 行の字幕の描き方の既定。null はプロジェクトの既定（AI で作った動画は bold）。UserTemplate では常に null（書式をそのまま描く）
      - `fontSize` integer: 基本の文字サイズ（px、横長 1920 幅で）。render_mp4 / プロジェクトの fontSize があればそちらが勝つ
      - `color` string: #rrggbb・#rrggbbaa・rgb(r,g,b)・rgba(r,g,b,a)
      - `fontWeight` integer
      - `outlineColor` string: #rrggbb・#rrggbbaa・rgb(r,g,b)・rgba(r,g,b,a)
      - `outlineWidth` number
      - `backgroundColor` string, nullable: 箱の色。null は話者の色の半透明
      - `backgroundPadding` number
      - `backgroundBorderRadius` number
      - `textAlign` 'left' | 'center' | 'right'
      - `letterSpacing` number
      - `lineHeight` number
      - `shadowColor` string: UserTemplate のみ
      - `shadowBlur` number: UserTemplate のみ
      - `animation` string: UserTemplate のみ
      - `speakerName` 'none' | 'inline' | 'above' | 'badge'
    - `characters` object[], required
      - `slot` string, required
      - `label` string
      - `character` string
      - `flip` boolean: 左右反転（yukkuri-talk 系には無い）
      - `voiceOnly` boolean, required
    - `camera` object: yukkuri-talk 系には無い（寄りは固定）
      - `zoomScale` number
      - `backgroundBlurOnZoom` boolean
    - `bgm` object, required
      - `volume` number: 0〜1（0.3 が標準）
      - `ducking` boolean: 話している間だけ BGM を下げるか（既定 false）
    - `background` object, required
      - `imageUrl` string, nullable
      - `videoUrl` string, nullable
      - `color` string: UserTemplate のみ
    - `unsupported` string[], required: このテンプレートでは描かれない項目（PATCH に渡すと 400 unsupported_field）
  - `notes` string[]: 効かない組み合わせの知らせ（例: look が bold のときの color）

## Other responses

- `401`: 未認証
- `403`: 権限不足（projects:read）
- `404`: テンプレートが無い・他人の非公開（template_not_found）

## Changes

- **2026-10-20** `ba5f36b016da`: 15 warning, 9 info
  - 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`
  - added the new `render_not_paid` enum value to the `code` response property for the response status `401`
  - …20 more

[Operation history](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/changes/api/v1/agent/templates/:templateId/style/get.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)