---
title: "テンプレートの位置関係を読む"
method: GET
path: "/api/v1/agent/templates/{templateId}/layout"
tags: ["agent"]
---

# テンプレートの位置関係を読む

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

## Request

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

## Path parameters

- `templateId` string, required

## Response `200`

位置

- object
  - `templateId` string, required
  - `source` 'system' | 'mine' | 'shared'
  - `layout` object, required: キャラの枠・字幕・素材の枠の位置（画面に対する %）
    - `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

## Other responses

- `401`: 未認証
- `403`: 権限不足（projects:read。直す PATCH は projects:write）
- `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/layout/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)