---
title: "使えるテンプレートの一覧"
method: GET
path: "/api/v1/agent/templates"
tags: ["agent"]
---

# 使えるテンプレートの一覧

`GET /api/v1/agent/templates`

## Request

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

## Response `200`

一覧

- object
  - `templates` object[], required
    - `id` string, required: templateId にそのまま渡せる
    - `style` TemplateStyle: テンプレートの見た目（描かれている値）。描き手は元の組み込みで決まる: 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）
    - `name` string, required
    - `description` string
    - `source` 'system' | 'mine', required
    - `basedOn` string: 組み込みから複製したときの元（その組み込みの見た目で描かれる）
    - `layout` object: キャラの枠・字幕・素材の枠の位置（画面に対する %）
      - `characters` object[], required
        - `slot` string, required
        - `label` string
        - `character` string
        - `x` number, required
        - `y` number, required
        - `width` number, required
        - `height` number, required
      - `subtitle` object, nullable: 画面に対する %（x/y は左上）
        - `x` number
        - `y` number
        - `width` number
        - `height` number
      - `material` object, nullable: 行ごとの素材画像（materialImageUrl）が出る枠
        - `x` number
        - `y` number
        - `width` number
        - `height` number
    - `portraitLayout` object: 縦型（9:16）の配置。無いテンプレートでは項目ごと無い
      - `characters` object[], required
        - `slot` string, required
        - `label` string
        - `character` string
        - `x` number, required
        - `y` number, required
        - `width` number, required
        - `height` number, required
      - `subtitle` object, nullable: 画面に対する %（x/y は左上）
        - `x` number
        - `y` number
        - `width` number
        - `height` number
      - `material` object, nullable: 行ごとの素材画像（materialImageUrl）が出る枠
        - `x` number
        - `y` number
        - `width` number
        - `height` number
  - `note` string

## Other responses

- `401`: 未認証
- `403`: 権限不足（projects:read / code: insufficient_scope）

## Changes

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

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