scenario-sparc3d

Scenario Sparc3D 画像から3Dへの変換

概要

Scenario 上の Hitem3D の画像から3Dへの変換ファミリーである Sparc3D は、テキストプロンプトなしで1〜4枚の写真から水密メッシュを生成します。画像がそのままアートディレクション全体を担います。ベースラインは小道具やオブジェクトに対応し、Portrait ラインは人間の頭部や胸像に対応します。それぞれに2.1世代と2.0世代があります。search でモデルを見つけ、model_schema_get を仕様として扱ってください。利用できるパラメーターや値の表記はモデルごとに異なります。

接続方法と基本的なループについては、このリポジトリの scenario スキルを参照してください。モデルに依存しない3D作業については scenario-3d スキルを参照してください。ここに記載されている関連スキルが利用可能なスキルにない場合は、ユーザーにインストールを依頼してください（npx skills add scenario-labs/skills --skill <name>）。無人実行の場合はツールスキーマに従って進め、不足しているスキルについて明示してください。

クイックリファレンス

ライブスキーマ上の名称と、執筆時点での相違点：

パラメーター	役割	メンバー間の相違点
images	1〜4方向のビュー：正面、次に背面、左、右	同じ
requestType	数値：メッシュのみ、またはメッシュとテクスチャ	同じ
resolution	ディテールとトポロジーの品質段階	2.1では 1536fast／1536pro、2.1 Portraitでは 1536profast／1536pro、2.0では 1536／1536pro。2.0 Portraitにはありません
face	対象の面数。100K〜2M、デフォルトは2M	2.0にはありません
pbr	PBRマテリアル。デフォルトはtrue	テクスチャ出力がない場合は機能しません

執筆時点では、requestType が1の場合はメッシュのみ、3（デフォルト）の場合はテクスチャ付きでした。解像度のデフォルト値は異なります。2.1では高速段階、2.1 Portraitではproが選択されます。

ビューの順序

images では、1番目のスロットが正面ビューです。追加の画像は同一の被写体の背面、左、右の順に指定します。正面ビューだけでも機能しますが、追加のビューを使うと、見えない側の形状がより安定します。背景が無地で、被写体が1つ、中央に配置されている画像が最適です。

長時間のジョブと変動する価格

resolution は生成時のディテールを指定し、face は出力メッシュのデータ量を設定します（軽量アセットなら500K、高忠実度なら2M）。requestType、resolution、pbr はすべてコストに影響し、執筆時点では同一メンバー内でも4倍の差が生じます。そのため、バッチ処理の前に正確なパラメーターセットで dry_run を実行してください。実行時間は長く（執筆時点で中央値は約17〜21分、遅い方の四分位では30分を超えます）、jobs_wait のタイムアウトは正常です。pending_job_ids を使って再呼び出ししてください。2回目の model_run は実行せず、job_get によるポーリングもしないでください。

作業例：1 枚のコンセプト画像からゲーム用小道具を作成する

1. search を target="models"、query="sparc3d"、public=true で実行します。最新の 非推奨ではないベースモデルの候補を優先します。例：model_hitem-sparc-3d-2-1（執筆時点で有効な候補です。 各セッションで再検索してください）。
2. その ID を指定して model_schema_get を実行します。ノブの有無と resolution の表記は、この情報のみを参照します。
3. コンセプト画像を upload_asset でアップロードするか、先にテキストから画像を生成するモデルで作成します。
4. その model_id を指定し、dry_run=true と parameters={"images": ["asset_front"], "requestType": 3, "resolution": "1536fast", "face": 500000, "pbr": true} を指定して model_run を実行し、料金を見積もります。料金に関わるノブを変更したら、再見積もりしてください。
5. wait=false を指定して model_run を再実行し、返されたジョブ ID を指定して jobs_wait を呼び出します。タイムアウトした場合は、 pending_job_ids を指定して再度呼び出します。数回の繰り返しが必要になる場合があります。
6. asset_display でメッシュをプレビューし、asset_download でエンジンにインポートします。コンテナを選択するスキーマフィールドはありません（カタログには GLB、OBJ、STL、FBX が記載されています）。エンジンの対応形式を約束する前に、返されたアセットで納品形式を確認してください。

よくある間違い

• prompt を渡す：テキストを受け取るメンバーはありません。方向性はソース画像で指定します。
• images に文字列をそのまま渡す：1 つの視点でも ["asset_x"] の形式で渡します。
• 1 番目のスロットに側面図を指定する：正面として読み取られます。
• メンバー間でノブの指定を使い回す：プロ以外のティアは 3 通りの表記があり、2.0 では face がなく、2.0 Portrait では resolution がありません。
• メッシュのみの実行で pbr がテクスチャを適用すると期待する：requestType でテクスチャを要求した場合にのみ機能します。
• クリーチャーや小道具に Portrait を使う：Portrait は頭部と顔に特化しており、高品質ティアではありません。