scenario-skyboxes

シナリオのスカイボックスと360度パノラマ

概要

Scenario は、継ぎ目のない正距円筒図法の360度パノラマを生成する専用のスカイボックスモデルと、継ぎ目を維持するスカイボックスアップスケーラーを提供しています。一般的な画像モデルでは通常得られない継ぎ目の連続性と極の形状を確保するため、必ず汎用画像モデルではなく、スカイボックス専用モデルで生成してください。

接続方法と基本的な生成手順については、このリポジトリの scenario スキルを参照してください。ここで名前を挙げた関連スキルが利用可能なスキルに見つからない場合は、ユーザーにインストールを依頼してください （npx skills add scenario-labs/skills --skill <name>）。無人実行の場合は、ツールのスキーマをもとに作業を進め、不足している点を明示してください。

クイックリファレンス

手順	ツール	目的
1	search（target="models", query="skybox", public=true）	現在利用可能なスカイボックスモデルを検索
2	model_schema_get	選択したモデルの正確なパラメーター仕様
3	model_run	料金確認には dry_run=true、バッチ処理には wait=false
4	jobs_wait	タイムアウト時は pending_job_ids を指定して再度呼び出す
5	asset_display / asset_download	インラインで確認してからファイルを保存

モデル ID と以下のパラメーター情報は、執筆時点での search の検索結果です。利用可能状況はチームごとに異なり、変更されるため、毎回あらためて検索してください。

• model_scenario-skybox-flux：テキストから360度パノラマを生成します。スタイルプリセットの列挙型（数は変動するため、スキーマで確認してください）、自動継ぎ目・極補正、強度スライダー付きのオプションの参照画像に対応します。
• model_scenario-skybox-gpt：最大10枚の参照画像をもとに、テキストから360度パノラマを生成します。品質プリセットに対応し、幅と高さは最大3840 px です。
• model_hunyuan-world-image-to-skybox：場所を撮影した写真1枚から、継ぎ目のない360度スカイボックスを生成します。
• model_sc-upscale-flux-skybox：継ぎ目のないラップを維持しながら、スカイボックスを2倍から8倍にアップスケールします。

作業例：生成、調整、エクスポート

例：ゲームシーン用の様式化された森のスカイボックス。

1. target="models"、query="skybox"、public=true を指定して search します。テキストからスカイボックスを生成するモデルを選びます。たとえば、model_scenario-skybox-flux です。
2. そのモデルに対して model_schema_get を実行します。prompt、style、negativePrompt、image、strength、numOutputs、geometryEnforcement、seed などのフィールドが表示されます。negativePromptStrength が 0 より大きくない限り、negativePrompt は機能しません。
3. parameters={"prompt": "ancient pine forest at dawn, mist between trunks, god rays", "style": "cinematic", "numOutputs": 2} を指定して model_run を実行します。style のプリセット名はスキーマの応答から取得してください。まず dry_run=true で実行料金を確認し、wait=false で起動します。
4. 返された job_id を job_ids=[...] に指定して jobs_wait を実行します。約180秒のタイムアウトはエラーではありません。返された pending_job_ids を job_ids として指定して再度呼び出してください。2回目の model_run は実行しないでください。その後、各出力に対して asset_display を実行します。
5. 雰囲気を調整します。最良の結果から seed をコピーし、style だけを変更します（cinematic、oil-painting、cyberpunk など）。構図を維持しながら見た目を変えるには、お気に入りを image として渡し、strength を低め（0.2～0.4）にします。コンセプトアートから雰囲気を調整する場合は、model_scenario-skybox-gpt に切り替えて referenceImages を渡します。
6. エクスポート：image=asset_id を指定して model_sc-upscale-flux-skybox を実行し、目標に達する最小の upscaleFactor を指定します（アップスケールには生成の数倍の費用がかかる場合があります。また、入力アセットが存在するまで dry_run は一度しか実行できないため、前もって一連の処理の料金を確認することはできません）。baseModel のデフォルトは FLUX.1-dev（様式化）です。Krea ベースのリアリズム設定もあり、strength のデフォルトは 0.6 で、ディテールが新たに生成されます。同じパノラマを高解像度にすることが目的なら、strength を下げてください。切り替える前に、model_schema_get で正確な使用可能値を確認します。その後、最後のアセットに対して asset_download を実行します。
7. シームを無料で確認します。保存した PNG の左端と右端のピクセル列を比較します。シームレスなパノラマでは、その差はほぼゼロになります。一方、4分の1回転離れた列の差は、桁違いに大きくなります。

エンジン形式に関する注意：Skybox Flux は正距円筒図法のパノラマを出力します。デフォルトのサイズ（作成時は1536x768）を維持し、サイズを決めつけず、返されたアセットから実際の寸法を確認してください。Skybox GPT のカタログには、正距円筒図法の2:1に加えて、キューブマップストリップの6:1とキューブマップクロスの4:3のレイアウトが記載されていますが、スキーマに表示されるのは幅と高さだけです。そのため、キューブマップレイアウトを前提にする前に、model_schema_get でレイアウトの仕様を確認してください。平面の背景以外にも、同じ検索で model_hunyuan-world-skybox-to-splat が見つかります。また、query="world" で別途検索すると Marble のワールドモデルが見つかります。どちらも、完成したパノラマをナビゲーション可能な3Dガウシアンスプラットシーンに変換します。このパイプラインは scenario-3d-worlds スキルで最初から最後まで学べます。

よくある間違い

• 汎用画像モデルに「360 panorama」をプロンプトで指定する：端がつながらず、極がにじみます。専用のスカイボックスモデルを使用してください。
• 汎用アップスケーラーでアップスケールする：つなぎ目の連続性が崩れます。スカイボックス用アップスケーラーを使用してください。
• スクリプトやドキュメントにモデル ID をハードコードする：search で再度検索してください。カタログは変更されます。
• Skybox Flux でプロンプトの表現を工夫してシームや極の歪みに対処する：代わりに geometryEnforcement を 0 より大きくしてください。ただし、歪みが実際に見える場合に限ります。
• Skybox GPT で正距円筒図法の出力を期待しながら、幅と高さの比率を2:1以外にする：360度表示を正しく行うには、2:1（たとえば2048x1024）を維持してください。
• model_schema_get を省略する：スカイボックスモデルには、汎用的な前提では見落とされるモデル固有のフィールド（style、geometryEnforcement、quality）があります。