# 画像生成

作りたい画像を自然な言葉で説明するだけで、Treasure AI Studioが会話内で画像を作成します。ゼロから画像を生成するだけでなく、AIはあなたが用意した画像を編集することもできます。マスクで指定した領域の描き直し、商品画像へのロゴの合成、既存画像のスタイル変更などが可能で、結果をインラインでレンダリングするため、チャットを離れることなく確認・ダウンロードできます。

注意
画像生成は、サンドボックス実行環境内の`tas-imggen`コマンドを通じて実行され、OpenAIのGPT Imageモデルを使用します。自然言語のリクエストに応じてAIが代わりにコマンドを実行するため、コマンドを覚える必要はありません。すべての実行はツールコールの展開部分に表示されるので、どのプロンプトとオプションが使われたかを正確に確認できます。

インストールしたプラグインやスキルによって動作が変わる場合があります
画像生成を独自にサポートするプラグインやスキルをインストールしている場合、AIがリクエストをここで説明する組み込みの`tas-imggen`ワークフローではなく、そのプラグイン側で処理することがあり、結果・オプション・出力が異なる場合があります。画像生成がドキュメントどおりに動作しない場合は、有効になっている[スキルとマーケットプレイス](/ja/products/ai-studio/skills/skills)のプラグインを確認し、画像生成を扱うものを無効化してください。

## 目的

チャット内の自然言語リクエストを通じて新しい画像を作成したり既存の画像を編集したりし、出力のサイズ・品質・フォーマットを制御し、生成された画像をインラインで閲覧またはダウンロードできるようにします。

## 前提条件

- Treasure AI Studioにサインイン済みであること（[はじめに](/ja/products/ai-studio/getting-started)）
- 画像生成を含むTreasure AI Studioプランであること（この機能は無料アカウントでは利用できません）


## AIを通じた画像の生成

画像を作成する最もシンプルな方法は、作りたいものを説明することです。

- 「*Northwind*というコーヒーブランド向けのミニマルなロゴを、白背景のフラットなベクタースタイルで作成して」
- 「夕暮れの街のスカイラインのヒーローバナーを、横長のアスペクト比で生成して」
- 「手を振っているフレンドリーなロボットのイラストを、背景透過で作って」


AIはあなたのリクエストを画像プロンプトに変換し、`tas-imggen generate`を実行して、完成した画像をチャットストリームにインラインでレンダリングします。

Treasure AI Studioのチャット画面：Northwindというコーヒーブランドのミニマルなロゴ作成を自然言語で依頼し、AIがtas-imggen --helpとtas-imggen generateをツールコールで実行、生成されたロゴがArtifactsパネルに表示されている様子
### 内部での処理の流れ

1. **画像を自然言語で説明する**
2. **AIがプロンプトを組み立て**、Bashツールを通じて生成コマンドを実行します。`tas-imggen generate --prompt "..."`
3. **ツールコールがチャットに表示され**、使用されているコマンドとオプションが示されます
4. **生成が完了すると画像がインラインでレンダリングされ**、セッション内にファイルとして保存されます
5. **AIが会話を続けます** — 修正、バリエーション、より高品質なバージョンを依頼できます


各ステップはリアルタイムで確認できます。コマンドの実行中はスピナーで進行状況が示され、完了すると画像が表示され、ツールコールが展開可能になるため、正確なプロンプトとオプションを確認できます。

## 既存の画像の編集

セッション内にすでにある画像（アップロードしたもの、またはAIが以前生成したもの）の編集をAIに依頼できます。AIは`tas-imggen edit`を使用し、これは次の2つの一般的なワークフローをサポートします。

| ワークフロー | 機能 | リクエスト例 |
|  --- | --- | --- |
| **マスク編集（インペインティング）** | 画像の特定の領域に絞って編集し、それ以外はできるだけ元の状態を保ちます。AIは、変更する領域を透明部分で示したマスクを準備します。 | 「この写真の空だけを夕焼けに変更して」 |
| **被写体ベース／合成編集** | 1枚以上の入力画像を素材として使い、新しい画像を作成します。たとえば、商品にロゴを配置したり、複数の画像の要素を組み合わせたりします。 | 「この商品写真のTシャツの前面に、このロゴを配置して」 |


AIは1回の編集に**最大16枚の入力画像**を渡すことができます。これは、被写体・参照スタイル・ブランドアセットを1つのリクエストで組み合わせる場合に便利です。

編集する画像を明示してください
セッション内に画像が複数ある場合は、編集したいファイルをAIに明確に伝えてください。ファイル名で指定する（たとえば「*hero-v2.png*を編集して」）か、誤解の余地なく説明する（「さっきアップロードしたロゴ」）かのいずれかです。AIは`tas-imggen edit`に具体的なファイルパスを渡すため、明確に指定することで意図しない画像が編集されるのを防げます。指定しないと、AIが意図とは別のファイルを選んでしまう場合があります。

マスクはAIが用意します
マスクを手作業で作る必要はありません。マスク編集を依頼すると、AIがあなたの説明を解釈してマスク自体を用意し、描き直す領域を指定します。AIは説明に基づいてマスクの位置を決めるため、領域はできるだけ明確に説明してください（たとえば「背景だけを変更して」）。説明が曖昧だと、意図しない領域が選ばれることがあります。

モデルは画像を再レンダリングするため、編集領域以外もまったく同一のまま保たれるとは限らず、わずかに変化する場合があります。それ以外の部分を完全にそのまま残したい場合は、再生成した領域をマスクを使って元画像に合成するようAIに依頼してください。

## 出力の制御

特定のサイズ・品質・ファイルフォーマットを依頼することで、出力を調整できます。AIがあなたのリクエストを対応するオプションにマッピングします。

### サイズ

| リクエスト | 結果のサイズ |
|  --- | --- |
| 「正方形の画像」 | `1024x1024` |
| 「横長／ワイド」 | `1536x1024` |
| 「縦長／トール」 | `1024x1536` |
| 「モデルに任せる」 | `auto`（デフォルト） |


**新規に生成する**画像では、カスタムサイズを依頼することもできます。幅と高さはそれぞれ16で割り切れる必要があり、アスペクト比は1:3〜3:1の範囲内、総解像度はおよそ3840x2160を超えてはなりません。**編集**では、`auto`または上記3つの標準サイズのみがサポートされます。

### 品質

**low**、**medium**、**high**、**auto**から品質を選べます。実用的なパターンは、安価に反復してから仕上げる方法です。

- プロンプトを練り込む間は**low**から始める — 生成が速く、消費クレジットも少なくて済みます
- 構図に満足したら**high**で再生成する


### ファイルフォーマット

出力フォーマットはファイル拡張子によって選択されます。デフォルトはPNGで、JPG/JPEGとWebPもサポートされています。

- 「JPEGで保存して」→ `.jpg`
- 「WebPでエクスポートして」→ `.webp`
- （指定なし）→ `.png`


## 生成された画像の表示場所

生成・編集された画像は現在のセッション内にファイルとして保存され、チャット内と**Artifactsパネル**の両方に表示されます。次のことが可能です。

- 生成が完了するとすぐに、チャットストリーム内で**インライン表示**する（直接ダウンロードできるファイルカードも表示されます）
- 右側の**Artifactsパネルを開く**ことで、画像の拡大・ダウンロード・削除ができます（[アーティファクト出力](/ja/products/ai-studio/files/artifacts)を参照）
- 画像をフィットするように拡大縮小する**イメージビューアーで開く**（[ファイルビューアー](/ja/products/ai-studio/files/file-viewers)を参照）
- チャットのファイルカードまたはファイルパネルから**ダウンロードする**（[ファイルのアップロードとダウンロード](/ja/products/ai-studio/files/file-upload-download)を参照）


## クレジットと使用量

画像生成はTreasure AI Studioのクレジットを消費します。画像生成は通常、テキスト応答よりも高コストで、**high**品質は**low**や**medium**よりもコストが高くなります。使用量を効率的に保つには、low品質で反復し、最終レンダリングのときだけhighに切り替えてください。管理者は[クレジット利用状況ダッシュボード](/ja/products/ai-studio/credits/credit-usage)で消費を監視し、[クレジットポリシー](/ja/products/ai-studio/credits/credit-policy)で上限を設定できます。

## ベストプラクティス

1. **説明は具体的に。** 被写体、スタイル（たとえば「フラットなベクター」「フォトリアリスティック」「水彩」）、背景、雰囲気を伝えましょう。詳細を多く伝えるほど、最初の結果が望むものに近づきます。
2. **low品質で反復する。** プロンプトと構図はlow品質で練り込み、満足したらhigh品質で一度だけ再生成することで、クレジットと時間を節約できます。
3. **編集する領域を説明する。** マスク編集では、何を変更し何を維持するかを明確に伝えましょう（「背景だけを置き換えて」）。AIがあなたの説明からマスクを準備します。
4. **合成には明確な入力画像を用意する。** 画像（ロゴ、商品写真、参照スタイル）を組み合わせるようAIに依頼する場合は、最良の結果のために高解像度のソースをアップロードしてください。
5. **最初に適切なサイズを依頼する。** 必要なアスペクト比（正方形、横長、縦長）を依頼しておくと、寸法を直すために再生成する必要がなくなります。


## 検証

- [ ] 「コーヒーブランド向けのシンプルな正方形ロゴを作成して」と依頼し、`tas-imggen generate`を実行するツールコールが表示されることを確認する
- [ ] 生成された画像がチャット内にインラインでレンダリングされることを確認する
- [ ] 画像をアップロードし、特定の領域の編集をAIに依頼して結果を比較する
- [ ] ツールコールを展開し、使用された正確なプロンプトとオプションを確認する


## トラブルシューティング

| 問題 | 解決策 |
|  --- | --- |
| 画像生成が実行されない | アカウントが画像生成を含むプランであることを確認してください。この機能は無料アカウントでは利用できません。有効化についてはカスタマーサクセスマネージャーにお問い合わせください。 |
| 画像生成がドキュメントと異なる動作をする | インストールしたプラグインやスキルが、組み込みのワークフローの代わりに画像生成を処理している可能性があります。有効になっている[スキルとマーケットプレイス](/ja/products/ai-studio/skills/skills)のプラグインを確認し、独自に画像生成を行うものを無効化してください。 |
| 結果がプロンプトと一致しない | 詳細（被写体、スタイル、背景）を追加して再生成してください。小さな修正であれば、全体を再生成するのではなくマスク編集を依頼してください。 |
| AIが意図と違う画像を編集してしまう | セッション内に画像が複数ある場合は、対象ファイルをファイル名で明示する（たとえば「*product-2.png*を編集して」）か、明確に説明してください。これにより、AIが正しいファイルを編集コマンドに渡せます。 |
| マスク編集で意図しない領域が変更された | 領域をより正確に説明してください（「空だけ」「ロゴの部分だけ」）。AIがあなたの説明からマスクを作り直します。 |
| カスタムサイズが拒否される | 生成画像では、幅と高さはそれぞれ16で割り切れ、アスペクト比は1:3〜3:1の範囲内、解像度はおよそ3840x2160以下である必要があります。編集では`auto`または標準サイズ（1024x1024、1536x1024、1024x1536）のみがサポートされます。 |
| 生成が遅い、またはコストが高いと感じる | 反復中は品質を`low`または`medium`に下げ、`high`は最終画像のために確保してください。 |


## 次のステップ

- [ファイルビューアー](/ja/products/ai-studio/files/file-viewers) — 組み込みのイメージビューアーで生成画像をプレビューする
- [ファイルのアップロードとダウンロード](/ja/products/ai-studio/files/file-upload-download) — ソース画像をアップロードし、生成結果をダウンロードする
- [チャートとデータビジュアライゼーション](/ja/products/ai-studio/visualization/charts) — データをチャートとしてチャット内にレンダリングする
- [クレジット利用状況ダッシュボード](/ja/products/ai-studio/credits/credit-usage) — クレジット消費を監視する