image-3d

image-3d

Starchild 上のすべての 3D 風画像生成リクエストにはこのスキルを使用してください。

対象範囲: 3D キャラクターデザイン (ちび、リアル、カートゥーン、ファンタジー)、3D 製品レンダー (フローティング、エクスプローデッド、ターンテーブル)、アイソメトリック調のジオラマ & ミニチュアシーン、3D アプリアイコン (iOS、Material、ゲーム)、3D テキストエフェクト (クローム、ネオン、木目、キャンディ)、インテリアデザインのビジュアライゼーション (モダン、ラグジュアリー、コージー、インダストリアル)、建築レンダリング (モダン、トラディショナル、フューチャリスティック、俯瞰、夜景)、3D シーン (ファンタジー、SF、自然、都市)、ゲームアセットのレンダー (武器、環境、プロップ、車両)。

中核となる原則: 提供されたスクリプトを呼び出してください。プロキシや課金の配管を再実装しないでください。

⚠️ 重要な区別 — 3D 風画像と 3D モデルファイル:

• このスキルは 3D 風の 2D 画像 (PNG/JPG) を生成します — 3D に見えるレンダリング済みの画像です
• このスキルは 3D モデルファイル (.glb、.obj、.fbx、.usdz) を生成しません
• 実際の 3D モデルファイルが必要な場合、ユーザーは専用の 3D モデリングサービス (Meshy など) を利用する必要があります

image-3d と他の画像スキルの使い分け:

• image-3d → ユーザーが 3D レンダリング風の見た目を求めている場合: 3D キャラクター、アイソメトリックシーン、3D アイコン、建築レンダー、インテリアデザインレンダー、3D テキストエフェクト
• image-create → ユーザーが一般的なクリエイティブ画像 (ロゴ、ポスター、イラスト、ミーム) を求めている場合 — image-create には基本的な 3d カテゴリがありますが、image-3d のほうがはるかに細かい制御が可能です
• image-ecommerce → ユーザーが E コマース掲載用の製品写真 (白背景、ライフスタイルショット) を求めている場合
• image-edit → ユーザーが既存の画像を編集・変換したい場合
• image-portrait → ユーザーが顔や本人性を保持したポートレートを求めている場合

---

1. クイックスタート — テキストから 3D 画像 (最も一般的)

⚠️ 実行コンテキスト — まずこれを読んでください。 以下のコードブロックはPythonであり、シェルコマンドではありません。Starchild の bash ツールは /bin/bash -c を実行するため、exec(open(...)) を解析できません — これらを直接 bash コマンドに貼り付けると syntax error near unexpected token 'open' で失敗します。 また、python3 -c 内の exec(open(...)) は NameError: __file__ で失敗します。 これはスクリプトがパス解決に __file__ を使用しているためです。

bash ツール経由で呼び出す場合は、from exports import を伴う python3 - <<'EOF' を使用してください:

python3 - <<'EOF'
import sys
sys.path.insert(0, "skills/image-3d")
from exports import generate_3d
result = generate_3d(
    prompt="a cute robot assistant with big eyes and antenna",
    category="character",
    style="chibi",
)
print(result)
EOF

ヒアドキュメント (<<'EOF') はすべての引用符と改行を保持します — エスケープは不要です。

exec(open('skills/image-3d/generate_3d.py').read())
result = generate_3d(
    prompt="a cute robot assistant with big eyes and antenna",
    category="character",
    style="chibi",
)
# result -> {"success": True, "images": [{"local_path": "output/images/..."}], ...}

2. クイックスタート — カテゴリ + スタイルのみ (カスタムプロンプトなし)

exec(open('skills/image-3d/generate_3d.py').read())
result = generate_3d(
    category="diorama",
    style="isometric",
)
# Uses the built-in style template as the full prompt

3. クイックスタート — 参照画像 → 3D スタイル

exec(open('skills/image-3d/generate_3d.py').read())
result = generate_3d(
    prompt="transform into a 3D rendered character",
    reference_path="uploads/sketch.jpg",
    category="character",
    style="cartoon",
)

ユーザーへの結果の配信 — 重要

ユーザーに生の fal.media URL を絶対に渡さないでください。 fal は制限的な CSP ヘッダーでファイルを配信します。唯一信頼できる配信経路は、すでにダウンロード済みのローカルファイルです:

1. 各画像の local_path (例: output/images/xxx.png) を使用してください — スクリプトは成功時に必ずダウンロードします。
2. ファイルが output/images/ に保存されており、ワークスペースのファイルパネルで閲覧できることをユーザーに伝えてください。
3. Web チャネルでは、ユーザーがチャット内でプレビューできるようにインラインで埋め込んでください:

   ![3d-render](output/images/<filename>.png)
   

4. Telegram / WeChat では、send_to_telegram(file_path="output/images/...", message_type="image") または send_to_wechat(file_path="output/images/...", message_type="image") 経由で送信してください。

---

4. パラメータ

パラメータ	必須	デフォルト	説明
prompt	はい*	—	生成したい 3D 画像のテキストによる説明
reference_path	いいえ	—	参照画像のローカルファイルパス（3D スタイル化用）
reference_url	いいえ	—	参照画像の公開 HTTPS URL
category	いいえ	"character"	3D カテゴリのプリセット（§5 を参照）
style	いいえ	"default"	カテゴリ内のサブスタイル（§5 を参照）
model	いいえ	"nanopro"	モデル: "nanopro"（高速 約25秒）または "gpt"（最高品質 約150秒）
count	いいえ	1	生成する画像の枚数（1〜4）
aspect_ratio	いいえ	自動	出力比率: 1:1、3:4、4:3、9:16、16:9。未設定の場合はカテゴリに応じて自動選択されます。

*テキストから画像を生成するモードでは、デフォルト以外の style を指定しない限り prompt が必須です（style には組み込みテンプレートが用意されています）。

プロンプトの優先順位: prompt + category/style（拡張） > prompt のみ > category + style テンプレート > category のデフォルト。

アスペクト比の自動選択: 明示的に設定されていない場合、スクリプトはカテゴリに最適な比率を選択します:

• キャラクターには 3:4（縦向き）
• 製品、ジオラマ、アイコン、ゲームアセットには 1:1（正方形のショーケース）
• テキスト、インテリア、建築、シーンには 16:9（ワイドなシネマティック）

---

5. カテゴリとスタイルプリセット

N: 3D キャラクター（category="character"）

スタイル	キー	最適な用途
ちび / Pixar	chibi	かわいいスタイル化されたキャラクター、マスコット、アバター
リアル	realistic	ゲーム向けキャラクター、詳細な人体構造
カートゥーン	cartoon	Disney/Pixar スタイル、ファミリー向け
ファンタジー	fantasy	RPG キャラクター、戦士、魔法使い
汎用	default	あらゆる 3D キャラクター

キャラクター向けプロンプトのヒント:

• ポーズ、服装、表情、アクセサリーを描写します
• キャラクターシートには「白い背景」または「クリーンな背景」を指定します
• ゲームキャラクターの場合は「T ポーズ」または「アクションポーズ」に言及します
• 例: "a female elf ranger with green cloak, holding a bow, forest background"

N: 3D 製品レンダリング（category="product"）

スタイル	キー	最適な用途
フローティング 3/4 アングル	floating	ヒーロー製品ショット、マーケティング
分解図	exploded	テクニカルイラスト、内部構造
ターンテーブル / 360°	turntable	多角度ショーケース
汎用	default	あらゆる製品レンダリング

製品向けプロンプトのヒント:

• 素材（マット、光沢、金属、木、ガラス）を描写します
• 照明（スタジオ、ドラマチック、ソフト、リムライト）を指定します
• 製品の種類と主な特徴に言及します
• 例: "wireless earbuds in charging case, matte white, floating angle"

N: 3D ジオラマ / アイソメトリック（category="diorama"）

スタイル	キー	最適な用途
アイソメトリック	isometric	ミニチュアの世界、街区、ゲームマップ
ローポリ	lowpoly	スタイル化されたシーン、インディーゲームの美学
リアル	realistic	建築模型、詳細なミニチュア
汎用	default	あらゆるジオラマシーン

ジオラマ向けプロンプトのヒント:

• シーンの内容（建物、木、キャラクター、乗り物）を描写します
• スケール（「ミニチュア」、「小さな」、「ドールハウス」）に言及します
• 雰囲気（暖かい、居心地の良い、ドラマチック、気まぐれな）を指定します
• 例: "a cozy Japanese ramen shop at night, tiny customers inside, warm glow"

N: 3D アイコン（category="icon"）

スタイル	キー	最適な用途
iOS スタイル	ios	Apple App Store のアイコン、光沢のあるガラス
Material Design	material	Google Play のアイコン、奥行きのあるフラット
ゲームアイコン	game	RPG アイテム、ファンタジーゲームの UI
汎用	default	あらゆる 3D アイコン

アイコン向けプロンプトのヒント:

• アイコンの題材をシンプルに描写します（主要な要素を 1 つ）
• 形状のコンテキスト（「角丸の正方形」、「円形」）を指定します
• シンプルに保ちます — アイコンは小さいサイズでも認識できる必要があります
• 例: "a camera icon with rainbow lens flare"

N: 3D テキスト (category="text")

スタイル	キー	最適な用途
クローム / メタリック	chrome	太字のタイトル、映画風のテキスト
ネオン輝光	neon	サイバーパンク、ナイトライフ、看板
ウッド	wood	素朴、クラフト、ナチュラルなブランド
キャンディ	candy	遊び心、子ども向け、スイートなテーマ
汎用	default	あらゆる 3D テキストエフェクト

テキストプロンプトのヒント:

• ⚠️ AI によるテキストレンダリングは信頼性が低いため、テキストは短くしてください（最大 1〜3 語）
• テキストの内容を引用符で記述します: "the word 'HELLO'"
• マテリアルと環境を指定します
• 例: "the word 'GAME OVER' in chrome metallic letters, dark background"

L: インテリアデザイン (category="interior")

スタイル	キー	最適な用途
モダンミニマリスト	modern	スカンジナビア風、クリーンなライン、自然光
ラグジュアリー	luxury	ハイエンド、大理石、ゴールドのアクセント
居心地の良さ / ヒュッゲ	cozy	暖かく、快適で、魅力的
インダストリアル	industrial	ロフト、むき出しのレンガ、アーバンシック
汎用	default	あらゆるインテリアレンダー

インテリアプロンプトのヒント:

• 部屋の種類を記述します（リビングルーム、寝室、キッチン、バスルーム、オフィス）
• 主要な家具とマテリアルに言及します
• 照明を指定します（自然光、暖かな夕方、ドラマチック）
• 重要な場合はカラーパレットを指定します
• 例: "modern Scandinavian living room with large windows, light wood floors, gray sofa, indoor plants"

L: 建築 (category="architecture")

スタイル	キー	最適な用途
モダン	modern	現代建築、ガラスとスチール
伝統的	traditional	古典、遺産、石と木
未来的	futuristic	SF、有機的なフォルム、グリーンテック
空撮ビュー	aerial	鳥瞰、マスタープラン、敷地の状況
夜景	night	ドラマチックな照明、ファサードのアップライト
汎用	default	あらゆる建築レンダー

建築プロンプトのヒント:

• 建物の種類を記述します（住宅、オフィス、タワー、美術館、学校）
• マテリアルに言及します（コンクリート、ガラス、スチール、木、石、レンガ）
• 環境を指定します（都市、郊外、丘陵地、ウォーターフロント）
• 照明のための時間帯に言及します（ゴールデンアワー、正午、夕暮れ、夜）
• 例: "modern three-story house with flat roof, large glass windows, surrounded by garden, golden hour"

N: 3D シーン (category="scene")

スタイル	キー	最適な用途
ファンタジー	fantasy	魔法の世界、浮遊島
SF	scifi	宇宙ステーション、未来的なテクノロジー
自然	nature	森林、景観、自然の美しさ
都市	urban	街路、サイバーパンク、ネオン
汎用	default	あらゆる 3D シーン

N: ゲームアセット (category="game_asset")

スタイル	キー	最適な用途
武器	weapon	剣、銃、魔法の武器
環境	environment	ゲームレベル、ワールドデザイン
プロップ	prop	アイテム、オブジェクト、コレクティブル
乗り物	vehicle	車、船、航空機
汎用	default	あらゆるゲームアセット

---

6. 3D レンダリングのキーワードガイド

カスタムプロンプトを作成する際は、これらのキーワードを使って 3D の見た目を制御します:

マテリアル

キーワード	効果
PBR materials	物理ベースレンダリング、リアルな表面
subsurface scattering	半透明の肌、ワックス、大理石
metallic / chrome	反射する金属表面
glossy / matte	表面仕上げの制御
glass / transparent	透けるマテリアル
clay render	マットなグレー、テクスチャなし、形状重視

ライティング

キーワード	効果
studio lighting	クリーン、プロフェッショナル、制御された
HDRI lighting	環境ベース、自然な反射
rim light	エッジのハイライト、被写体の分離
volumetric lighting	ゴッドレイ、大気の奥行き
ambient occlusion	柔らかな接触影、奥行き
global illumination	リアルな光の跳ね返り

カメラ / 構図

キーワード	効果
isometric view	45° のトップダウン、透視歪みなし
3/4 angle	定番の製品・キャラクター紹介アングル
eye level	自然な人間の視点
bird's eye view	トップダウンの俯瞰視点
tilt-shift	ミニチュア・ジオラマ風の効果
depth of field	背景ぼかし、被写体にフォーカス

レンダリングエンジンのスタイル

キーワード	効果
octane render	高品質でフォトリアル
Blender Cycles	リアルなパストレーシング
Unreal Engine 5	ゲーム品質のリアルタイムな見た目
V-Ray	建築ビジュアライゼーション品質
Cinema 4D	クリーンでスタイライズされた 3D
KeyShot	製品ビジュアライゼーション品質

---

7. モデル選択ガイド

モデル	キー	速度	品質	最適な用途
Nano Banana Pro	nanopro	約25秒	良好	素早い反復、ドラフト、ほとんどの 3D スタイル
GPT Image 2	gpt	約150秒	最高	最終レンダリング、複雑なシーン、細部

カテゴリ別の推奨事項:

• キャラクター → ドラフトには nanopro、最終的なキャラクターシートには gpt
• 製品 → フォトリアルなレンダリングには gpt、素早いコンセプトには nanopro
• ジオラマ → アイソメトリックは nanopro が得意です。詳細なミニチュアには gpt
• アイコン → ほとんどのアイコンには nanopro で十分です
• テキスト → テキストのレンダリング精度が高い gpt(それでも完全ではありません)
• インテリア / 建築 → フォトリアルな建築ビジュアライゼーションには gpt、コンセプトには nanopro
• シーン → シネマティックな品質には gpt、素早いムードボードには nanopro

---

8. アスペクト比ガイド

カテゴリ	デフォルト	推奨される代替
character	3:4	アバターには 1:1、全身には 9:16
product	1:1	横長のショーケースには 4:3
diorama	1:1	パノラマジオラマには 16:9
icon	1:1	常に 1:1
text	16:9	正方形バナーには 1:1
interior	16:9	室内ビューには 4:3、縦長には 3:4
architecture	16:9	高層ビルには 3:4、空撮には 1:1
scene	16:9	縦長のシーンには 9:16
game_asset	1:1	キャラクターアセットには 3:4

---

9. 意図認識ガイド

ユーザーのリクエストを適切なカテゴリ + スタイルにマッピングします:

ユーザーの発言...	カテゴリ	スタイル	備考
"3D character"、"Pixar style character"	character	chibi または cartoon
"game character"、"RPG hero"	character	fantasy
"realistic 3D person"	character	realistic
"3D product render"、"product visualization"	product	floating
"exploded view"、"internal structure"	product	exploded
"isometric"、"miniature scene"、"tiny world"	diorama	isometric
"low poly scene"、"stylized environment"	diorama	lowpoly
"app icon"、"iOS icon"	icon	ios
"game icon"、"RPG item icon"	icon	game
"3D text"、"chrome text"、"metallic letters"	text	chrome
"neon sign"、"glowing text"	text	neon
"interior design"、"room design"、"装修效果图"	interior	modern
"luxury interior"、"penthouse"	interior	luxury
"cozy room"、"warm interior"	interior	cozy
"building render"、"architecture visualization"	architecture	modern
"night render"、"building at night"	architecture	night
"aerial view"、"masterplan"	architecture	aerial
"fantasy world"、"magical scene"	scene	fantasy
"sci-fi scene"、"space station"	scene	scifi
"game weapon"、"sword render"	game_asset	weapon
"game environment"、"level design"	game_asset	environment

---

10. エラー処理

エラー	原因	対処
"Unknown model"	無効なモデルキー	"nanopro" または "gpt" を使用してください
"Unknown category"	無効なカテゴリ	有効なカテゴリについては §5 を確認してください
"Unknown style"	カテゴリに存在しないスタイル	そのカテゴリのスタイル表を確認してください
"File not found"	reference_path が存在しない	ファイルパスを確認してください
"Image too large"	参照画像が 10 MB 超	画像をリサイズまたは圧縮してください
"Submit failed"	API エラー	FAL_KEY を確認して、再試行してください
"Generation timed out"	モデルの処理に時間がかかりすぎた	再試行するか、nanopro に切り替えてください

---

11. 応用例

3D キャラクターシート（複数アングル）

exec(open('skills/image-3d/generate_3d.py').read())
result = generate_3d(
    prompt="a steampunk inventor character with goggles, leather apron, and mechanical arm, character sheet showing front and side views",
    category="character",
    style="realistic",
    model="gpt",
    aspect_ratio="16:9",
)

アイソメトリックな街区

exec(open('skills/image-3d/generate_3d.py').read())
result = generate_3d(
    prompt="a bustling Tokyo street corner with ramen shop, vending machines, and cherry blossom trees, tiny people walking",
    category="diorama",
    style="isometric",
)

建築のナイトレンダー

exec(open('skills/image-3d/generate_3d.py').read())
result = generate_3d(
    prompt="a modern art museum with curved glass facade, reflecting pool in front, dramatic uplighting",
    category="architecture",
    style="night",
    model="gpt",
)

インテリアデザイン — モダンなリビングルーム

exec(open('skills/image-3d/generate_3d.py').read())
result = generate_3d(
    prompt="spacious living room with floor-to-ceiling windows overlooking city skyline, minimalist furniture, warm wood accents, indoor plants",
    category="interior",
    style="modern",
    model="gpt",
)

参照画像 → 3D スタイル

exec(open('skills/image-3d/generate_3d.py').read())
result = generate_3d(
    prompt="transform into a 3D Pixar-style character with exaggerated features",
    reference_path="uploads/photo.jpg",
    category="character",
    style="cartoon",
)

3D ゲーム用武器

exec(open('skills/image-3d/generate_3d.py').read())
result = generate_3d(
    prompt="legendary fire sword with glowing runes, ember particles, dark background",
    category="game_asset",
    style="weapon",
)

3D ネオンテキスト

exec(open('skills/image-3d/generate_3d.py').read())
result = generate_3d(
    prompt="the word 'CYBER' in neon pink and blue letters, wet street reflection",
    category="text",
    style="neon",
)

比較用の複数画像

exec(open('skills/image-3d/generate_3d.py').read())
result = generate_3d(
    prompt="a cozy coffee shop interior with exposed brick and warm lighting",
    category="interior",
    style="cozy",
    count=3,
    model="nanopro",
)
# Generates 3 variations for the user to choose from