scenario-reve について
Reve の画像モデルを Scenario で扱うためのスキルです。Reve v2.1 と Reve Remix の選び方や、それぞれ異なる入力仕様に沿った生成、編集、合成の方法を説明します。
主な機能
- 01Reve v2.1 による画像生成と編集
- 02Reve Remix による複数画像の合成
- 03モデル別の参照画像とアスペクト比設定
- 04番号タグによる v2.1 の参照画像指定
- 05画像ジョブの見積もり、実行、確認
活用シーン
- 01プロンプトからの画像生成や既存画像の編集
- 02写真、イラスト、デザイン素材の合成
- 03ポスターの文字を視覚的なスタイルを保って変更
MCP 対応
Scenario の MCP ツールでモデルを検索し、スキーマを取得して、参照アセットのアップロードと画像ジョブの実行を行います。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ scenario-labs/ skills --skill scenario-reveインストール後、Claude Code で/scenario-reveを入力して読み込まれたか確認します。
詳細
Scenario Reve Image
概要
Scenario の Reve は Reve AI の画像モデルファミリーで、ブランドを共有する以外はほとんど異なる 2 つのモデルに分かれています。v2.1 は推論を重視した生成モデル兼指示編集モデルで、執筆時点ではテキストから画像を生成するアリーナで上位 2 位に入っています。Remix は複数の画像を 1 枚に合成する、高速で低コストなコンポジターです。search で見つけ、model_schema_get を仕様として扱ってください。フィールド名、プロンプトの上限、アスペクト比の一覧はそれぞれ異なります。
接続と基本的な使い方については、このリポジトリの scenario スキルを参照してください。モデルに依存しない画像処理については、scenario-image スキルを参照してください。ここに記載した関連スキルが利用可能なスキルにない場合は、ユーザーにインストールを依頼してください(npx skills add scenario-labs/skills --skill <name>)。無人で処理を進める場合は、ツールスキーマに基づいて作業し、不足している点を明記してください。
クイックリファレンス
執筆時点の情報です(実際に使用する際は最新のスキーマを優先してください)。
| モデル | 機能 | 参照画像 | プロンプト上限 | アスペクト比 |
|---|---|---|---|---|
| Reve v2.1 | txt2img, img2img | references、任意 | 4000 | 18 種類、4:1 から 1:4、デフォルトは auto |
| Reve Remix | img2img | referenceImages、必須、1~6 枚 | 2560 | 7 種類、16:9 から 9:16、デフォルトは 3:2 |
どちらのモデルもパラメーターは 3 つです。プロンプト、参照画像の配列、aspectRatio です。どちらもマスク、シード、幅と高さ、ネガティブプロンプト、バッチ数のフィールドはありません。そのため、編集範囲は指示の文言で指定し、サイズはアスペクト比のみで決まります。auto(v2.1 のみ)は適切な形状を選びます。納品物に特定の比率が必要な場合は、明示的に指定してください。
作業内容に応じて選んでください。v2.1 は、プロンプトだけからの生成と、ポスターの文字の差し替え、商品の色変更、素材の変更、照明やスタイルの変更、すべての被写体の一貫性を保ちながら参照画像を統合する、といった精密な編集に対応します。Remix は、写真、イラスト、デザイン素材をまとまりのある 1 枚の画像に合成します。どちらでもよい場合は、両方で dry_run を実行してください。執筆時点では、v2.1 の実行コストは Remix の数倍で、p50 の所要時間も 1 分を超えていました。一方、Remix は 20 数秒でした。
フレームタグで v2.1 の参照画像を指定する
v2.1 のプロンプトでは、<frame>N</frame> タグを使って参照画像を指定します。番号は references 内のアセットの順に 0 から始まります。最初の画像は <frame>0</frame>、2 番目は <frame>1</frame> です。参照画像が複数ある場合は、必ずタグを使ってください。タグがないと、モデルはどの画像を指しているのか推測します。Remix のドキュメントにはタグ構文がありません。対象を通常の言葉で指定してください(「最初の画像のボトル、2 番目の画像の照明」)。
編集はマスクではなく指示で行う
どちらのモデルもマスクを受け付けないため、編集内容はすべてプロンプトで指定します。変更する内容と、変更せずに維持する内容を明記してください。v2.1 はキーワードの羅列よりも具体的な自然言語の指示に適しており、4000 文字の上限があるため、制約を記述する余裕もあります。正確な領域を指定してマスク付きインペインティングを行う場合は、mask フィールドを公開しているモデルを使用してください(scenario-image を参照)。
ポスターのテキストを差し替える実例
target="models"、query="reve"、public=trueを指定してsearchを実行します。作成時点での検索結果はmodel_reve-v2-1(生成および指示による編集)とmodel_reve-remix(複数画像の合成)でした。 セッションごとに再度検索してください。- 選んだモデルに対して
model_schema_getを実行し、まずフィールド名、上限値、アスペクト比の一覧を確認します。 - ポスターに対して
upload_assetを実行し(scenarioスキルを参照)、アセット ID を取得します。 - コストを見積もるため、該当する
model_idとdry_run=trueを指定し、parameters={"prompt": "Replace the headline on the poster in <frame>0</frame> with 'SUMMER SALE', matching the original font, perspective, and lighting. Change nothing else.", "references": ["asset_x"], "aspectRatio": "auto"}を指定してmodel_runを実行します。 wait=falseを指定してmodel_runを再実行し、返されたジョブ ID を使ってjobs_waitを実行します。タイムアウトした場合はpending_job_idsを指定して再呼び出しし、model_runは決して2回目を実行しないでください。asset_displayで差し替えを確認してから、asset_downloadで保存します。
よくある間違い
- フレームを1から数えること:
<frame>1</frame>は2番目の参照です。1番目は<frame>0</frame>です。 - メンバー間でフィールド名を使い回すこと:v2.1 では
references、Remix ではreferenceImagesを使用します。各スキーマには、それぞれのメンバーで使うフィールドのみが記載されています。 - 参照なしで Remix を実行すること:
referenceImagesは必須です(作成時点では1~6個)。プロンプトのみの生成には v2.1 を使用します。 - 長さを確認せずに v2.1 のプロンプトを Remix で再利用すること:4000文字では上限の2560文字を超えます。
- 幅、高さ、マスク、シードを送信すること:どちらのメンバーにもありません。サイズを調整できるのは
aspectRatioのみです。 - v2.1 の
jobs_waitのタイムアウトをエラーとみなすこと:作成時点では p50 レイテンシーが1分を超えていたため、pending_job_idsを指定して再呼び出ししてください。