linkfox-multimodal-generate-image

AI 画像生成

このスキルでは、AI 画像生成サービスを使って画像を生成・編集する方法を説明します。ユーザーが高品質な商品画像を作成したり、既存の画像を変更したり、創造的なビジュアル変換を行ったりできるよう支援します。

基本概念

AI 画像生成ツールは、テキストプロンプトと任意の参照画像に基づいて新しい画像を生成します。幅広い用途に対応しています。

• テキストから画像へ：テキストによる説明だけをもとに、まったく新しい画像を生成します。
• 画像から画像へ：1 枚以上の参照画像とプロンプトを指定し、参照画像の要素を引き継いだ新しい画像を生成します。
• 画像編集：既存の画像内の特定の要素、色、背景、スタイルを変更します。
• 商品画像の合成：ある画像の商品を、別の画像のシーンに配置します。
• モデルの差し替え：商品写真のモデルまたはマネキンを差し替えます。

出力を既存の商品やシーンに近づけたい場合は、参照画像の指定を強くおすすめします。参照画像の URL は最大 3 件まで、コンマで区切って指定できます。

パラメーターガイド

パラメーター	必須	説明	デフォルト
prompt	はい	生成したい画像のテキストによる説明です。テキストから画像への生成、画像から画像への生成、編集、モデルの差し替えなどに対応しています。最大 1000 文字です。	--
referenceImageUrl	いいえ	参照画像の URL です。複数の URL はコンマで区切ります。最大 3 枚の画像に対応しています。最大 1000 文字です。	--
aspectRatio	いいえ	出力画像のアスペクト比です。	1:1

対応するアスペクト比

値	説明
1:1	正方形（デフォルト）
3:4	ポートレート
4:3	横長
9:16	縦向きフルスクリーン
16:9	横向きフルスクリーン

プロンプト作成のヒント

1. 具体的かつ詳しく記述する：被写体、シーン、照明、スタイル、雰囲気を明確に説明します。
2. 参照画像は番号で指定する：参照画像を使う場合は、referenceImageUrl に指定した順に「image 1」「image 2」などと呼びます。
3. 操作内容を明示する：「replace」「change」「put」「combine」「generate」など、明確な動詞を使います。
4. 1000 文字以内に収める：プロンプトの最大長は 1000 文字です。

シナリオ別のプロンプト例

オブジェクトの差し替え：

Replace the vase on the table in image 1 with a potted plant

背景色の変更：

Change the background color of image 1 to pure white

商品画像の合成：

Place the product from image 2 onto the marble countertop in image 1

スタイルの変換：

Transform image 1 into the artistic style shown in image 2

テキストから画像へ（参照画像なし）：

A professional product photo of a sleek black wireless headphone on a gradient blue background, studio lighting, 8K quality

モデルの差し替え：

Replace the model in image 1 with a different model while keeping the same clothing and pose

ローカル画像のアップロード

このツールで参照画像を使うには、誰でもアクセスできる画像 URL が必要です。ユーザーがローカル画像のファイルパス（例：C:\Users\...\photo.png、/home/.../image.jpg）を指定した場合は、先にアップロードして公開 URL を取得する必要があります。

アップロードスクリプトを実行します。

python scripts/upload_image.py /path/to/local/image.png

スクリプトは公開 URL（有効期間 24 時間）を返します。この URL を参照画像 URL パラメーターとして使用できます。

呼び出し方法

• API エンドポイント：POST /multimodal/generateImage（完全なパラメーター、レスポンス、エラーコードについては references/api.md を参照）
• Python スクリプト：python scripts/multimodal_generate_image.py '<JSON 参数>' [--inline]
• コストの制約：このツールは計算リソースを消費します。同じセッションで同じパラメーターの組み合わせを使う場合、デフォルトでは 1 回だけ呼び出されます。スクリプトには 24 時間のローカルキャッシュがあります。失敗した場合や結果が空の場合、自動でキーワードを変えたり、ページを移動したり、郵便番号を変えて連続して試したりしてはいけません。続けて検索する必要がある場合は、追加のコストが発生することを先にユーザーに伝えてください。

出力方針（スクリプトのデフォルト動作）：

• 常に、完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-multimodal-generate-image-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリです。Claude Code では現在のプロジェクトディレクトリにあたります。<session> は環境変数 SESSION_ID から取得され、ユーザーのタスクごとに自動でまとめられます。/tmp への書き込みは禁止です。 現在のディレクトリに書き込めない場合はエラーになります）
• レスポンス本文が 8 KB 以下の場合：ファイルに書き込んだ後、完全な JSON を stdout に出力します
• レスポンス本文が 8 KB を超える場合：ファイルに書き込んだ後、stdout には要約のみを出力します（トップレベルのフィールド、total／costToken などの一般的な件数、最大のリストフィールドの長さと先頭 3 件のサンプル）
• --inline を指定すると、ファイルにも書き込んだうえで stdout に全内容を強制的に出力します

データの読み取りに関する推奨事項：まず要約を確認して、必要な情報が得られるか判断します。具体的なフィールドが必要な場合は、JSON 全体がコンテキストに入るのを避けるため、保存した json ファイルから jqまたはConvertFrom-Json を使って必要な部分を抽出してください。

認証と計算リソースの問題解決

次のような異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。

異常な状況

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
• レスポンスのステータスコードが 401 または 402
• 計算リソースまたは残高の不足を示すレスポンス：メッセージに「計算リソース残高が不足しています／課金額が不足しています／残高が不足しています／quota exceeded／insufficient balance／プランの有効期限が切れています／チャージが必要です／チャージしてください」、または同様の意味の内容が含まれている場合。

表示ルール

1. 生成した画像を表示する：レスポンスの text フィールドに画像コンテンツが含まれている場合は、Markdown の画像構文を使ってユーザーに直接表示します。
2. ステータスを報告する：status フィールドと finished フィールドを確認します。画像生成がまだ進行中の場合は、その旨をユーザーに伝え、完了まで待つよう案内します。
3. プロンプトを明示する：どのようなプロンプトとパラメーターを送信したかを簡潔に説明し、ユーザーが依頼内容を把握できるようにします。
4. アスペクト比を確認する：ユーザーが寸法を指定していない場合は、デフォルトの 1:1 比率を使用することを伝え、必要であれば別の比率を指定できるよう案内します。
5. 参照画像について案内する：既存の画像に近い仕上がりを希望しているのに参照 URL が提供されていない場合は、忠実度を高めるため、参照 URL を提供するよう事前に提案します。
6. エラーに対応する：生成に失敗した場合は、レスポンスの status フィールドに基づいて問題を説明し、プロンプトを簡潔にする、参照画像の URL を確認する、別のアスペクト比を試すなどの調整を提案します。

重要な制限事項

• 参照画像の上限：1 回のリクエストで指定できる参照画像 URL は最大 3 件です。
• プロンプトの長さ：プロンプトは 1000 文字を超えてはいけません。
• URL の有効性：参照画像の URL は、誰でもアクセスできる必要があります。非公開または期限切れの URL は失敗の原因になります。
• アスペクト比の選択肢：対応しているのは 1:1、3:4、4:3、9:16、16:9 のみです。

ユーザーの表現とシナリオのクイックリファレンス

該当する — 画像生成または編集に関するリクエスト：

ユーザーの発言	シナリオ
「画像を生成して」「画像を作成して」	テキストからの画像生成
「この写真を編集して」「画像を変更して」	画像編集
「背景を変更して」「背景を白にして」	背景の置き換え
「このシーンに商品を配置して」	商品の合成
「このスタイルに似せて」	スタイル変換
「モデルを入れ替えて」「人物を変更して」	モデルの入れ替え
「商品写真を作成して」	商品画像の生成
「縦長／横長のバージョンを作成して」	アスペクト比の調整

該当しない — 画像生成以外の作業が必要なもの：

• 画像の分析や認識（画像内のテキストの読み取り、物体の識別）
• 動画の生成または編集
• 画像ファイル形式の変換
• 数百枚の画像の一括処理
• 画像のホスティングまたは保存

算力消耗規則

動的なルールに基づいて課金します：算力消費量 = rawTokens × 0.045。

重要：このスキルのサービス料金は倍率に応じて動的に計算され、1 回の利用で大量の算力を消費する可能性があります。必ずユーザーに注意を促し、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

次のいずれかに該当する場合は、Feedback API を通じてフィードバックを自動的に検出し、報告します。

1. このスキルで説明されている機能や目的が、実際の動作と一致しない
2. スキルの結果がユーザーの意図と一致しない
3. ユーザーがこのスキルへの不満または称賛を表明する
4. 改善できると思われる点がある

references/api.md に記載されている方法でフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

---

高品質でプロフェッショナルな越境 EC スキルをさらに利用するには、LinkFox Skills を設定してください。