---
title: "アセット、バージョン、@ハンドル"
description: "キャスト、セット、小道具、スタイルは、バージョンとリファレンス画像をもつアセットです。どのカットからも@ハンドルで呼び出せます。"
url: https://www.filmsquare.ai/docs/ja/concepts/elements/
lang: ja
section: concepts
updated: 2026-11-15
mcp: [get_script, view_media, upload_file, find_actions, run_action]
---

# アセット、バージョン、@ハンドル

アセットとは、どのカットでも同じ見た目でなければならないものです。キャスト、セット、小道具、スタイルがあたります。各アセットには、`@ハンドル`、リファレンス画像、バージョンがあります。一度OKを出せば、あとはハンドルで、どのカットからでも呼び出せます。

![キャスト、セット、小道具がカードで並び、種類ごとのフィルタがあるElements画面](https://www.filmsquare.ai/docs/shots/en/elements-desktop.webp)

## アセットの種類

| 種類 | アプリでの表示 | 部署 |
| --- | --- | --- |
| Character | キャスト | [キャスティング](https://www.filmsquare.ai/docs/ja/departments/casting/)、[衣装](https://www.filmsquare.ai/docs/ja/departments/wardrobe/) |
| Location | セット | [美術](https://www.filmsquare.ai/docs/ja/departments/sets/) |
| Prop | 小道具 | [小道具](https://www.filmsquare.ai/docs/ja/departments/props/) |
| Style | スタイル | ルック。カメラ、レンズ、ライト、グレーディング、フィルムの種類。[スタイル](https://www.filmsquare.ai/docs/ja/concepts/styles/)をご覧ください |

衣装は、それ自体がアセットではありません。キャストに付く、シーンごとの[スタイリング](https://www.filmsquare.ai/docs/ja/departments/wardrobe/)です。

## @ハンドル

すべてのアセットには、`@anna`や`@backlot-street`のようなハンドルがあります。プロンプト、カットの説明、コンポーザーで`@`を入力すると、アセットを呼び出せます。するとFilmsquareが、そのカットのサイズとアングルに合わせて選んだアセットのリファレンス画像を、テイクに自動で追加します。

**Elements**画面では、**Copy @handle**でハンドルをコピーでき、**Search elements or @handle**でアセットを検索できます。

## アセットの置き場所

アセットは、1つの作品に属するか、ワークスペース全体に属します（「Every production in this workspace」）。ワークスペース全体のアセットは、すべての作品で使えます。作品に属するアセットは、その作品でだけ使えます。作品では、**Cast & sets → Cast**、**Locations**、**Props**でアセットを扱い、スタイルは**Create → Mood**で扱います。作品には、その作品専用の**Elements**ページもあり、新しい作品の**Home**にボタンがあります。そこには、作品のアセットと、その作品が使っているワークスペース全体のアセット（**Every production**と表示）が並びます。たとえば、取り込んだテイクが名指ししているアセットです。そこで追加したものは、その作品の中にとどまります。ワークスペース全体のアセットを変更すると、どこでも反映されます。スタッフを割り当てられるのは、作品に属するアセットだけです。

## アセットをつくる

- **カット割りから：** 脚本をカット割りすると、見つかったキャスト、セット、小道具が入ります。
- **Add elements：** Elementsページで、写真をどこにでもドロップします（複数選択もできます）。それぞれが下書きのカードになり、種類と名前がファイル名から読み取られます（`chr_ines_v3.png`ならキャストのInes）。両方を確認して、まとめて**Add**します。各写真が、アセットの最初のリファレンスになります。
- **文章で説明する：** **Kind**（種類）と**Name**（名前）を選び、一文を書きます。Filmsquareがリファレンスシートをレンダリングし、最初の1枚を使います。
- **Save as element：** 気に入ったテイクを、キャスト、セット、小道具にします。そのテイクが最初のリファレンスになります。
- **タグから：** **Script → Tagging**のタグの隣にある**Create**で、そのタグが指すキャスト、セット、小道具をつくります。
- **New look：** **Create → Mood**で、選んだ画像からスタイルをつくります。[キャンバス](https://www.filmsquare.ai/docs/ja/working-together/canvas/#looks)をご覧ください。
- **New style：** **Create → Styles**で、スタイルガイドを書いてリファレンス画像を足すか、ライブラリのものを使います。[スタイル](https://www.filmsquare.ai/docs/ja/concepts/styles/)をご覧ください。

## バージョン

アセットの見た目に加える変更は、すべて新しいバージョンになります。バージョンは、一度つくると変わらないので、それを使ったカットはいつでも再現できます。いちばん新しいバージョンが**Current**です。カットは、古いバージョンに固定しない限り、現在のバージョンを使います。

アセットのページで**New version**を押すと、現在のバージョンが、すべてのリファレンスごと次のバージョンとしてコピーされます。そのあとで、リファレンスを追加したり変更したりします。

![バージョン、リファレンス画像、シートが並ぶアセットのページ](https://www.filmsquare.ai/docs/shots/en/element-detail-desktop.webp)

> [!NOTE]
> あるバージョンでテイクをつくると、そのバージョンのリファレンスは固定されます。リファレンスを追加するには、新しいバージョンをつくります。APIは、対処法を添えて`409 element_version_frozen`を返します。

## リファレンスとシート

リファレンスは、役割をもったアセットの画像です。正面、斜め、横顔、後ろ、全身、ターンアラウンド、表情、ディテール、引き、ほかにもいくつかあります。**Add reference**で1枚アップロードします。現在のバージョンの画像の横の×を押すと、その画像が外れます。Filmsquareが、その画像のない新しいバージョンをつくり、古いバージョンには残ります。

**シート**は、アセットをすっきりと見せた画像で、リファレンスとして使うためにレンダリングします。アセットのページからレンダリングし、納得できたら**Sign off as reference**（リファレンスとしてOK）を押します。Filmsquareが、その画像を加えた新しいバージョンをつくります。

## バージョンとOK

アセットの新しいバージョン（v2以降）は、OK済みの作業の変更にあたります。そのアセットを使っている、作業中のすべてのエピソードで、対応する部署が要再OKになります。

| アセット | 要再OKになる部署 |
| --- | --- |
| キャスト | キャスティング、衣装、ボイス |
| セット | 美術 |
| 小道具 | 小道具 |

新しいアセット（v1）では起きません。それを取り込んだカット割りは、すでにOK済みだからです。[OKと関門](https://www.filmsquare.ai/docs/ja/concepts/sign-off-and-gates/#when-a-sign-off-goes-stale)をご覧ください。

## アーカイブ

**Archive…**で、アセットが一覧から外れます。それを使ったカットとテイクの履歴は残ります。削除されるものはありません。

## お手持ちのClaudeで

`get_script`は、作品にすでにあるハンドルを返すので、カット割りでそれらを再利用できます。`view_media`は、リファレンス画像をClaudeに見せます。`upload_file`は、リファレンス用の画像を作品のアセットとして追加します。バージョン、リファレンス、シートは、`find_actions`と`run_action`を通して扱います（たとえば`forkElementVersion`、`generateForElement`、`acceptElementTake`）。`removeElementReferences`は、アセットから古い画像を外します。それがない新しいバージョンが現在のバージョンになり、以前のバージョンには残ります。詳しくは[Claudeでできること](https://www.filmsquare.ai/docs/ja/claude/tools/)をご覧ください。
