image-3d

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

image-3d

Use this skill for all 3D-style image generation requests on Starchild.

Covers: 3D character design (chibi, realistic, cartoon, fantasy), 3D product renders (floating, exploded, turntable), isometric dioramas & miniature scenes, 3D app icons (iOS, Material, game), 3D text effects (chrome, neon, wood, candy), interior design visualization (modern, luxury, cozy, industrial), architectural rendering (modern, traditional, futuristic, aerial, night), 3D scenes (fantasy, sci-fi, nature, urban), and game asset renders (weapons, environments, props, vehicles).

Core principle: call the provided script. Do not re-implement proxy/billing plumbing.

⚠️ Important distinction — 3D-style images vs 3D model files:

This skill generates 3D-style 2D images (PNG/JPG) — rendered pictures that look 3D
This skill does NOT produce 3D model files (.glb, .obj, .fbx, .usdz)
For actual 3D model files, users need dedicated 3D modeling services (Meshy, etc.)

When to use image-3d vs other image skills:

image-3d → user wants a 3D-rendered look: 3D characters, isometric scenes, 3D icons, architectural renders, interior design renders, 3D text effects
image-create → user wants general creative images (logos, posters, illustrations, memes) — image-create has a basic
```
3d
```
category, but image-3d offers far more granular control
image-ecommerce → user wants product photos for e-commerce listings (white background, lifestyle shots)
image-edit → user wants to edit/transform an existing image
image-portrait → user wants a portrait with face/identity preserved

在Starchild上，所有3D风格图像生成请求都可使用此技能。

涵盖范围：3D角色设计（chibi、写实、卡通、奇幻风格）、3D产品渲染图（悬浮视角、爆炸视图、旋转展示）、等距立体场景与微缩场景、3D应用图标（iOS、Material Design、游戏风格）、3D文字效果（铬金属、霓虹、木质、糖果风格）、室内设计可视化效果（现代简约、奢华、温馨舒适、工业风）、建筑渲染图（现代、传统、未来主义、航拍、夜景）、3D场景（奇幻、科幻、自然、都市）以及游戏资产渲染图（武器、环境、道具、载具）。

**核心原则：**调用提供的脚本。请勿重新实现代理/计费相关流程。

⚠️ 重要区分——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 → 用户需要通用创意图像（logo、海报、插画、表情包）——image-create包含基础的
```
3d
```
分类，但image-3d提供更精细的控制
image-ecommerce → 用户需要用于电商列表的产品照片（白底图、场景图）
image-edit → 用户需要编辑/转换现有图像
image-portrait → 用户需要保留面部/身份特征的肖像图

1. Quick start — text-to-3D image (most common)

1. 快速入门——文本转3D图像（最常用）

python

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",
)

python

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/..."}], ...}

undefined

undefined

2. Quick start — category + style only (no custom prompt)

2. 快速入门——仅指定分类+风格（无需自定义提示词）

python

exec(open('skills/image-3d/generate_3d.py').read())
result = generate_3d(
    category="diorama",
    style="isometric",
)

python

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

使用内置风格模板作为完整提示词

undefined

undefined

3. Quick start — reference image → 3D style

3. 快速入门——参考图像转3D风格

python

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",
)

python

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",
)

Delivering the result to the user — IMPORTANT

向用户交付结果的注意事项——重要

Never hand the user the raw fal.media URL. fal serves files with restrictive CSP headers. The only reliable delivery path is the already-downloaded local file:

Use each image's
```
local_path
```
(e.g.
```
output/images/xxx.png
```
) — the script always downloads on success.
Tell the user the files are saved to
```
output/images/
```
and viewable in the workspace file panel.
On Web channel, embed inline so the user can preview in chat:
markdown
```
![3d-render](output/images/<filename>.png)
```

On Telegram / WeChat: send via

send_to_telegram(file_path="output/images/...", message_type="image")

send_to_wechat(file_path="output/images/...", message_type="image")

切勿直接提供用户原始fal.media链接。fal提供的文件带有严格的CSP头，唯一可靠的交付方式是已下载的本地文件：

使用每张图片的
```
local_path
```
（例如
```
output/images/xxx.png
```
）——脚本在生成成功后总会自动下载文件
告知用户文件已保存至
```
output/images/
```
，可在工作区文件面板查看
在Web渠道，可将图片嵌入聊天内容以便用户预览：
markdown
```
![3d-render](output/images/<filename>.png)
```

在Telegram/微信渠道：使用

send_to_telegram(file_path="output/images/...", message_type="image")

或

send_to_wechat(file_path="output/images/...", message_type="image")

发送图片

4. Parameters

4. 参数说明

Parameter	Required	Default	Description
`prompt`	yes*	—	Text description of the desired 3D image
`reference_path`	no	—	Local file path to a reference image (for 3D stylization)
`reference_url`	no	—	Public HTTPS URL of a reference image
`category`	no	`"character"`	3D category preset (see §5)
`style`	no	`"default"`	Sub-style within the category (see §5)
`model`	no	`"nanopro"`	Model: `"nanopro"` (fast ~25s) or `"gpt"` (best quality ~150s)
`count`	no	`1`	Number of images to generate (1–4)
`aspect_ratio`	no	auto	Output ratio: `1:1` , `3:4` , `4:3` , `9:16` , `16:9` . Auto-selected by category if not set.

prompt

is required for text-to-image mode unless a non-default

style

is specified (which provides a built-in template).

Prompt priority:

prompt + category/style

(enhanced) >

prompt

only >

category + style

template >

category

default.

Aspect ratio auto-selection: When not explicitly set, the script picks the best ratio for the category:

```
3:4
```
for characters (portrait orientation)
```
1:1
```
for products, dioramas, icons, game assets (square showcase)
```
16:9
```
for text, interiors, architecture, scenes (wide cinematic)

参数	是否必填	默认值	说明
`prompt`	是*	—	所需3D图像的文本描述
`reference_path`	否	—	参考图像的本地文件路径（用于3D风格化）
`reference_url`	否	—	参考图像的公开HTTPS链接
`category`	否	`"character"`	3D分类预设（见第5节）
`style`	否	`"default"`	分类下的子风格（见第5节）
`model`	否	`"nanopro"`	模型选项： `"nanopro"` （快速，约25秒）或 `"gpt"` （最佳质量，约150秒）
`count`	否	`1`	生成图像数量（1-4张）
`aspect_ratio`	否	auto	输出比例： `1:1` 、 `3:4` 、 `4:3` 、 `9:16` 、 `16:9` 。若未设置，将根据分类自动选择。

*文本转图像模式下需要填写

prompt

，除非指定了非默认的

style

（该样式会提供内置模板）。

提示词优先级：

prompt + 分类/风格

（增强版） > 仅

prompt

分类 + 风格

模板 > 分类默认值

自动选择宽高比： 若未明确设置，脚本会根据分类选择最佳比例：

角色类：
```
3:4
```
（竖版肖像）
产品、立体场景、图标、游戏资产：
```
1:1
```
（方形展示）
文字、室内、建筑、场景：
```
16:9
```
（宽屏电影级）

5. Categories and style presets

5. 分类与风格预设

N: 3D Character (

category="character"

)

N: 3D角色（

category="character"

）

Style	Key	Best for
Chibi / Pixar	`chibi`	Cute stylized characters, mascots, avatars
Realistic	`realistic`	Game-ready characters, detailed anatomy
Cartoon	`cartoon`	Disney/Pixar style, family-friendly
Fantasy	`fantasy`	RPG characters, warriors, mages
General	`default`	Any 3D character

Character prompt tips:

Describe pose, outfit, expression, and accessories
Specify "white background" or "clean background" for character sheets
For game characters, mention "T-pose" or "action pose"

Example:

"a female elf ranger with green cloak, holding a bow, forest background"

风格	标识	适用场景
Chibi/皮克斯	`chibi`	可爱的风格化角色、吉祥物、头像
写实风格	`realistic`	游戏可用角色、精细解剖结构
卡通风格	`cartoon`	迪士尼/皮克斯风格、适合全年龄段
奇幻风格	`fantasy`	RPG角色、战士、法师
通用风格	`default`	任意3D角色

角色提示词技巧：

描述姿势、服装、表情和配饰
若需要角色展示图，可指定“白色背景”或“简洁背景”
游戏角色可提及“T字姿势”或“动作姿势”

示例：

"a female elf ranger with green cloak, holding a bow, forest background"

N: 3D Product Render (

category="product"

)

N: 3D产品渲染图（

category="product"

）

Style	Key	Best for
Floating 3/4 angle	`floating`	Hero product shots, marketing
Exploded view	`exploded`	Technical illustration, internal structure
Turntable / 360°	`turntable`	Multi-angle showcase
General	`default`	Any product render

Product prompt tips:

Describe material (matte, glossy, metallic, wood, glass)
Specify lighting (studio, dramatic, soft, rim light)
Mention the product type and key features

Example:

"wireless earbuds in charging case, matte white, floating angle"

风格	标识	适用场景
悬浮3/4视角	`floating`	产品主图、营销素材
爆炸视图	`exploded`	技术说明图、内部结构展示
旋转展示/360°	`turntable`	多角度产品展示
通用风格	`default`	任意产品渲染图

产品提示词技巧：

描述材质（哑光、亮面、金属、木质、玻璃）
指定灯光（影棚光、戏剧性灯光、柔和灯光、轮廓光）
提及产品类型和核心特性

示例：

"wireless earbuds in charging case, matte white, floating angle"

N: 3D Diorama / Isometric (

category="diorama"

)

N: 3D立体场景/等距视图（

category="diorama"

）

Style	Key	Best for
Isometric	`isometric`	Miniature worlds, city blocks, game maps
Low-poly	`lowpoly`	Stylized scenes, indie game aesthetic
Realistic	`realistic`	Architectural models, detailed miniatures
General	`default`	Any diorama scene

Diorama prompt tips:

Describe the scene contents (buildings, trees, characters, vehicles)
Mention scale ("miniature", "tiny", "dollhouse")
Specify mood (warm, cozy, dramatic, whimsical)

Example:

"a cozy Japanese ramen shop at night, tiny customers inside, warm glow"

风格	标识	适用场景
等距风格	`isometric`	微缩世界、城市街区、游戏地图
低多边形风格	`lowpoly`	风格化场景、独立游戏美学
写实风格	`realistic`	建筑模型、精细微缩场景
通用风格	`default`	任意立体场景

立体场景提示词技巧：

描述场景内容（建筑、树木、角色、载具）
提及比例（“微缩”、“极小”、“玩偶屋风格”）
指定氛围（温暖、舒适、戏剧性、奇幻）

示例：

"a cozy Japanese ramen shop at night, tiny customers inside, warm glow"

N: 3D Icon (

category="icon"

)

N: 3D图标（

category="icon"

）

Style	Key	Best for
iOS style	`ios`	Apple App Store icons, glossy glass
Material Design	`material`	Google Play icons, flat with depth
Game icon	`game`	RPG items, fantasy game UI
General	`default`	Any 3D icon

Icon prompt tips:

Describe the icon subject simply (one main element)
Specify the shape context ("rounded square", "circular")
Keep it simple — icons should be recognizable at small sizes
Example:
```
"a camera icon with rainbow lens flare"
```

风格	标识	适用场景
iOS风格	`ios`	Apple App Store图标、亮面玻璃效果
Material Design风格	`material`	Google Play图标、扁平化带层次感
游戏图标	`game`	RPG道具、奇幻游戏UI
通用风格	`default`	任意3D图标

图标提示词技巧：

简洁描述图标主体（单个核心元素）
指定形状背景（“圆角方形”、“圆形”）
保持简洁——图标在小尺寸下需易于识别
示例：
```
"a camera icon with rainbow lens flare"
```

N: 3D Text (

category="text"

)

N: 3D文字（

category="text"

）

Style	Key	Best for
Chrome / Metallic	`chrome`	Bold titles, movie-style text
Neon glow	`neon`	Cyberpunk, nightlife, signs
Wood	`wood`	Rustic, craft, natural brands
Candy	`candy`	Playful, kids, sweet themes
General	`default`	Any 3D text effect

Text prompt tips:

⚠️ AI text rendering is unreliable — keep text SHORT (1-3 words max)
Describe the text content in quotes:
```
"the word 'HELLO'"
```
Specify material and environment

Example:

"the word 'GAME OVER' in chrome metallic letters, dark background"

风格	标识	适用场景
铬金属/金属质感	`chrome`	醒目标题、电影风格文字
霓虹发光	`neon`	赛博朋克、夜生活、招牌文字
木质风格	`wood`	复古、手工艺、自然品牌
糖果风格	`candy`	趣味、儿童、甜美主题
通用风格	`default`	任意3D文字效果

文字提示词技巧：

⚠️ AI文字渲染效果不稳定——文字需简短（最多1-3个单词）
用引号描述文字内容：
```
"the word 'HELLO'"
```
指定材质和环境

示例：

"the word 'GAME OVER' in chrome metallic letters, dark background"

L: Interior Design (

category="interior"

)

L: 室内设计（

category="interior"

）

Style	Key	Best for
Modern minimalist	`modern`	Scandinavian, clean lines, natural light
Luxury	`luxury`	High-end, marble, gold accents
Cozy / Hygge	`cozy`	Warm, comfortable, inviting
Industrial	`industrial`	Loft, exposed brick, urban chic
General	`default`	Any interior render

Interior prompt tips:

Describe the room type (living room, bedroom, kitchen, bathroom, office)
Mention key furniture and materials
Specify lighting (natural daylight, warm evening, dramatic)
Specify color palette if important

Example:

"modern Scandinavian living room with large windows, light wood floors, gray sofa, indoor plants"

风格	标识	适用场景
现代简约	`modern`	斯堪的纳维亚风格、简洁线条、自然光
奢华风格	`luxury`	高端、大理石、金色装饰
温馨舒适/Hygge	`cozy`	温暖、舒适、有吸引力
工业风	`industrial`	阁楼、裸露砖墙、都市时尚
通用风格	`default`	任意室内渲染图

室内设计提示词技巧：

描述房间类型（客厅、卧室、厨房、浴室、办公室）
提及核心家具和材质
指定灯光（自然光、温暖夜晚灯光、戏剧性灯光）
若重要可指定配色方案

示例：

"modern Scandinavian living room with large windows, light wood floors, gray sofa, indoor plants"

L: Architecture (

category="architecture"

)

L: 建筑（

category="architecture"

）

Style	Key	Best for
Modern	`modern`	Contemporary buildings, glass & steel
Traditional	`traditional`	Classical, heritage, stone & wood
Futuristic	`futuristic`	Sci-fi, organic forms, green tech
Aerial view	`aerial`	Bird's eye, masterplan, site context
Night scene	`night`	Dramatic lighting, facade uplighting
General	`default`	Any architectural render

Architecture prompt tips:

Describe building type (house, office, tower, museum, school)
Mention materials (concrete, glass, steel, wood, stone, brick)
Specify environment (urban, suburban, hillside, waterfront)
Mention time of day for lighting (golden hour, midday, dusk, night)

Example:

"modern three-story house with flat roof, large glass windows, surrounded by garden, golden hour"

风格	标识	适用场景
现代风格	`modern`	当代建筑、玻璃与钢结构
传统风格	`traditional`	古典、历史建筑、石材与木结构
未来主义	`futuristic`	科幻、有机形态、绿色科技
航拍视角	`aerial`	鸟瞰图、总平面图、场地环境
夜景	`night`	戏剧性灯光、建筑立面照明
通用风格	`default`	任意建筑渲染图

建筑提示词技巧：

描述建筑类型（住宅、办公楼、塔楼、博物馆、学校）
提及材质（混凝土、玻璃、钢材、木材、石材、砖墙）
指定环境（都市、郊区、山坡、滨水）
提及时间以控制灯光（黄金时段、正午、黄昏、夜晚）

示例：

"modern three-story house with flat roof, large glass windows, surrounded by garden, golden hour"

N: 3D Scene (

category="scene"

)

N: 3D场景（

category="scene"

）

Style	Key	Best for
Fantasy	`fantasy`	Magical worlds, floating islands
Sci-fi	`scifi`	Space stations, futuristic tech
Nature	`nature`	Forests, landscapes, natural beauty
Urban	`urban`	City streets, cyberpunk, neon
General	`default`	Any 3D scene

风格	标识	适用场景
奇幻风格	`fantasy`	魔法世界、浮空岛
科幻风格	`scifi`	空间站、未来科技
自然风格	`nature`	森林、景观、自然美景
都市风格	`urban`	城市街道、赛博朋克、霓虹
通用风格	`default`	任意3D场景

N: Game Asset (

category="game_asset"

)

N: 游戏资产（

category="game_asset"

）

Style	Key	Best for
Weapon	`weapon`	Swords, guns, magical weapons
Environment	`environment`	Game levels, world design
Prop	`prop`	Items, objects, collectibles
Vehicle	`vehicle`	Cars, ships, aircraft
General	`default`	Any game asset

风格	标识	适用场景
武器	`weapon`	剑、枪、魔法武器
环境	`environment`	游戏关卡、世界设计
道具	`prop`	物品、对象、收藏品
载具	`vehicle`	汽车、船只、飞行器
通用风格	`default`	任意游戏资产

6. 3D Rendering keyword guide

6. 3D渲染关键词指南

When crafting custom prompts, use these keywords to control the 3D look:

编写自定义提示词时，可使用以下关键词控制3D效果：

Materials

材质

Keyword	Effect
`PBR materials`	Physically-based rendering, realistic surfaces
`subsurface scattering`	Translucent skin, wax, marble
`metallic / chrome`	Reflective metal surfaces
`glossy / matte`	Surface finish control
`glass / transparent`	See-through materials
`clay render`	Matte gray, no textures, shape focus

关键词	效果
`PBR materials`	基于物理的渲染，实现逼真的表面效果
`subsurface scattering`	半透明皮肤、蜡、大理石效果
`metallic / chrome`	反光金属表面
`glossy / matte`	表面光泽控制
`glass / transparent`	透明材质效果
`clay render`	哑光灰色、无纹理，聚焦形状

Lighting

灯光

Keyword	Effect
`studio lighting`	Clean, professional, controlled
`HDRI lighting`	Environment-based, natural reflections
`rim light`	Edge highlight, subject separation
`volumetric lighting`	God rays, atmospheric depth
`ambient occlusion`	Soft contact shadows, depth
`global illumination`	Realistic light bouncing

关键词	效果
`studio lighting`	干净、专业、可控的灯光
`HDRI lighting`	基于环境的灯光，实现自然反射
`rim light`	边缘高光，分离主体与背景
`volumetric lighting`	丁达尔效应、大气深度感
`ambient occlusion`	柔和接触阴影，增强深度
`global illumination`	逼真的光线反弹效果

Camera / Composition

相机/构图

Keyword	Effect
`isometric view`	45° top-down, no perspective distortion
`3/4 angle`	Classic product/character showcase angle
`eye level`	Natural human perspective
`bird's eye view`	Top-down aerial perspective
`tilt-shift`	Miniature/diorama effect
`depth of field`	Background blur, subject focus

关键词	效果
`isometric view`	45°俯视，无透视变形
`3/4 angle`	经典产品/角色展示视角
`eye level`	自然人类视角
`bird's eye view`	俯视航拍视角
`tilt-shift`	微缩/立体场景效果
`depth of field`	背景虚化，聚焦主体

Render Engine Style

渲染引擎风格

Keyword	Effect
`octane render`	High-quality, photorealistic
`Blender Cycles`	Realistic path tracing
`Unreal Engine 5`	Game-quality, real-time look
`V-Ray`	Architectural visualization quality
`Cinema 4D`	Clean, stylized 3D
`KeyShot`	Product visualization quality

关键词	效果
`octane render`	高质量、照片级写实
`Blender Cycles`	逼真的路径追踪
`Unreal Engine 5`	游戏级画质、实时渲染效果
`V-Ray`	建筑可视化级画质
`Cinema 4D`	干净、风格化3D效果
`KeyShot`	产品可视化级画质

7. Model selection guide

7. 模型选择指南

Model	Key	Speed	Quality	Best for
Nano Banana Pro	`nanopro`	~25s	Good	Quick iterations, drafts, most 3D styles
GPT Image 2	`gpt`	~150s	Best	Final renders, complex scenes, fine details

Recommendations by category:

Characters →
```
nanopro
```
for drafts,
```
gpt
```
for final character sheets
Products →
```
gpt
```
for photorealistic renders,
```
nanopro
```
for quick concepts
Dioramas →
```
nanopro
```
handles isometric well;
```
gpt
```
for detailed miniatures
Icons →
```
nanopro
```
is sufficient for most icons
Text →
```
gpt
```
for better text rendering (still imperfect)
Interior/Architecture →
```
gpt
```
for photorealistic archviz,
```
nanopro
```
for concepts
Scenes →
```
gpt
```
for cinematic quality,
```
nanopro
```
for quick mood boards

模型	标识	速度	质量	适用场景
Nano Banana Pro	`nanopro`	~25秒	良好	快速迭代、草稿、大多数3D风格
GPT Image 2	`gpt`	~150秒	最佳	最终渲染图、复杂场景、精细细节

按分类推荐：

角色 →
```
nanopro
```
用于草稿，
```
gpt
```
用于最终角色展示图
产品 →
```
gpt
```
用于照片级写实渲染，
```
nanopro
```
用于快速概念图
立体场景 →
```
nanopro
```
擅长等距风格；
```
gpt
```
用于精细微缩场景
图标 →
```
nanopro
```
足以应对大多数图标需求
文字 →
```
gpt
```
的文字渲染效果更好（仍有瑕疵）
室内/建筑 →
```
gpt
```
用于照片级建筑可视化，
```
nanopro
```
用于概念图
场景 →
```
gpt
```
用于电影级画质，
```
nanopro
```
用于快速情绪板

8. Aspect ratio guide

8. 宽高比指南

Category	Default	Recommended alternatives
character	`3:4`	`1:1` for avatar, `9:16` for full-body
product	`1:1`	`4:3` for landscape showcase
diorama	`1:1`	`16:9` for panoramic diorama
icon	`1:1`	Always `1:1`
text	`16:9`	`1:1` for square banners
interior	`16:9`	`4:3` for room views, `3:4` for vertical
architecture	`16:9`	`3:4` for tall buildings, `1:1` for aerial
scene	`16:9`	`9:16` for vertical scenes
game_asset	`1:1`	`3:4` for character assets

分类	默认比例	推荐替代比例
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. Intent recognition guide

9. 意图识别指南

Map user requests to the right category + style:

User says...	Category	Style
"3D character", "Pixar style character"	`character`	`chibi` or `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`

将用户请求映射到正确的分类+风格：

用户需求	分类	风格
"3D角色"、"皮克斯风格角色"	`character`	`chibi` 或 `cartoon`
"游戏角色"、"RPG英雄"	`character`	`fantasy`
"写实3D人物"	`character`	`realistic`
"3D产品渲染图"、"产品可视化"	`product`	`floating`
"爆炸视图"、"内部结构"	`product`	`exploded`
"等距视图"、"微缩场景"、"极小世界"	`diorama`	`isometric`
"低多边形场景"、"风格化环境"	`diorama`	`lowpoly`
"应用图标"、"iOS图标"	`icon`	`ios`
"游戏图标"、"RPG道具图标"	`icon`	`game`
"3D文字"、"铬金属文字"、"金属字母"	`text`	`chrome`
"霓虹灯牌"、"发光文字"	`text`	`neon`
"室内设计"、"房间设计"、"装修效果图"	`interior`	`modern`
"奢华室内"、"顶层公寓"	`interior`	`luxury`
"温馨房间"、"温暖室内"	`interior`	`cozy`
"建筑渲染图"、"建筑可视化"	`architecture`	`modern`
"夜景渲染"、"建筑夜景"	`architecture`	`night`
"航拍视角"、"总平面图"	`architecture`	`aerial`
"奇幻世界"、"魔法场景"	`scene`	`fantasy`
"科幻场景"、"空间站"	`scene`	`scifi`
"游戏武器"、"剑渲染图"	`game_asset`	`weapon`
"游戏环境"、"关卡设计"	`game_asset`	`environment`

10. Error handling

10. 错误处理

Error	Cause	Fix
`"Unknown model"`	Invalid model key	Use `"nanopro"` or `"gpt"`
`"Unknown category"`	Invalid category	Check §5 for valid categories
`"Unknown style"`	Style not in category	Check the style table for that category
`"File not found"`	reference_path doesn't exist	Verify the file path
`"Image too large"`	Reference image > 10 MB	Resize or compress the image
`"Submit failed"`	API error	Check FAL_KEY, retry
`"Generation timed out"`	Model took too long	Retry, or switch to `nanopro`

错误信息	原因	解决方法
`"Unknown model"`	模型标识无效	使用 `"nanopro"` 或 `"gpt"`
`"Unknown category"`	分类无效	查看第5节的有效分类
`"Unknown style"`	分类下无此风格	查看对应分类的风格表
`"File not found"`	reference_path不存在	验证文件路径
`"Image too large"`	参考图像超过10MB	调整图像大小或压缩
`"Submit failed"`	API错误	检查FAL_KEY，重试
`"Generation timed out"`	模型运行超时	重试，或切换为 `nanopro`

11. Advanced examples

11. 高级示例

3D character sheet (multiple angles)

3D角色展示图（多视角）

python

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",
)

python

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",
)

Isometric city block

等距城市街区

python

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",
)

python

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",
)

Architectural night render

建筑夜景渲染图

python

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",
)

python

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",
)

Interior design — modern living room

室内设计——现代客厅

python

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",
)

python

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",
)

Reference image → 3D style

参考图像转3D风格

python

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",
)

python

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 game weapon

3D游戏武器

python

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",
)

python

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 neon text

3D霓虹文字

python

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",
)

python

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",
)

Multiple images for comparison

多张对比图像

python

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",
)

python

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

生成3种变体供用户选择

undefined

undefined

image-3d

Original

Translation

image-3d

image-3d

1. Quick start — text-to-3D image (most common)

1. 快速入门——文本转3D图像（最常用）

result -> {"success": True, "images": [{"local_path": "output/images/..."}], ...}

result -> {"success": True, "images": [{"local_path": "output/images/..."}], ...}

2. Quick start — category + style only (no custom prompt)

2. 快速入门——仅指定分类+风格（无需自定义提示词）

Uses the built-in style template as the full prompt

使用内置风格模板作为完整提示词

3. Quick start — reference image → 3D style

3. 快速入门——参考图像转3D风格

Delivering the result to the user — IMPORTANT

向用户交付结果的注意事项——重要

4. Parameters

4. 参数说明

5. Categories and style presets

5. 分类与风格预设

N: 3D Character (category="character")

N: 3D角色（category="character"）

N: 3D Product Render (category="product")

N: 3D产品渲染图（category="product"）

N: 3D Diorama / Isometric (category="diorama")

N: 3D立体场景/等距视图（category="diorama"）

N: 3D Icon (category="icon")

N: 3D图标（category="icon"）

N: 3D Text (category="text")

N: 3D文字（category="text"）

L: Interior Design (category="interior")

L: 室内设计（category="interior"）

L: Architecture (category="architecture")

L: 建筑（category="architecture"）

N: 3D Scene (category="scene")

N: 3D场景（category="scene"）

N: Game Asset (category="game_asset")

N: 游戏资产（category="game_asset"）

6. 3D Rendering keyword guide

6. 3D渲染关键词指南

Materials

材质

Lighting

灯光

Camera / Composition

相机/构图

Render Engine Style

渲染引擎风格

7. Model selection guide

7. 模型选择指南

8. Aspect ratio guide

8. 宽高比指南

9. Intent recognition guide

9. 意图识别指南

10. Error handling

10. 错误处理

11. Advanced examples

11. 高级示例

3D character sheet (multiple angles)

3D角色展示图（多视角）

Isometric city block

等距城市街区

Architectural night render

建筑夜景渲染图

Interior design — modern living room

室内设计——现代客厅

Reference image → 3D style

参考图像转3D风格

3D game weapon

3D游戏武器

3D neon text

3D霓虹文字

Multiple images for comparison

多张对比图像

Generates 3 variations for the user to choose from

生成3种变体供用户选择

N: 3D Character (
`category="character"`
)

N: 3D角色（
`category="character"`
）

N: 3D Product Render (
`category="product"`
)

N: 3D产品渲染图（
`category="product"`
）

N: 3D Diorama / Isometric (
`category="diorama"`
)

N: 3D立体场景/等距视图（
`category="diorama"`
）

N: 3D Icon (
`category="icon"`
)

N: 3D图标（
`category="icon"`
）

N: 3D Text (
`category="text"`
)

N: 3D文字（
`category="text"`
）

L: Interior Design (
`category="interior"`
)

L: 室内设计（
`category="interior"`
）

L: Architecture (
`category="architecture"`
)

L: 建筑（
`category="architecture"`
）

N: 3D Scene (
`category="scene"`
)

N: 3D场景（
`category="scene"`
）

N: Game Asset (
`category="game_asset"`
)

N: 游戏资产（
`category="game_asset"`
）