用途
image-3d 用于在 Starchild 上处理所有 3D 风格的图像生成请求。它将类别预设与子风格模板结合，让用户以较少的参数获得特定方向的 3D 观感图像。
主要能力
该技能覆盖以下方向，每个方向下有若干风格预设：
- 3D 角色（category="character"）：chibi（Q版/Pixar 风格）、realistic（写实）、cartoon（卡通）、fantasy（奇幻）、default（通用）。
- 3D 产品渲染（category="product"）：floating（悬浮 3/4 视角）、exploded（爆炸图）、turntable（转盘/360°）、default。
- 3D 立体模型/等距场景（category="diorama"）：isometric（等距）、lowpoly（低多边形）、realistic、default。
- 3D 图标（category="icon"）：ios（iOS 风格）、material（Material Design）、game（游戏图标）、default。
- 3D 文字（category="text"）：chrome（铬/金属）、neon（霓虹光）、wood（木质）、candy（糖果）、default。
- 室内设计（category="interior"）：modern（现代极简）、luxury（奢华）、cozy（温馨）、industrial（工业风）、default。
- 建筑表现（category="architecture"）：modern（现代）、traditional（传统）、futuristic（未来）、aerial（鸟瞰）、night（夜景）、default。
- 3D 场景（category="scene"）：fantasy（奇幻）、scifi（科幻）、nature（自然）、urban（城市）、default。
- 游戏资产（category="game_asset"）：weapon（武器）、environment（环境）、prop（道具）、vehicle（载具）、default。
支持文生图、仅指定类别与风格（使用内置风格模板）、以及参考图转 3D 风格。
使用方式
脚本为 Python，需注意执行环境。通过 bash 工具调用时应使用 python3 - <<'EOF' 配合 from exports import：
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
也可使用：
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", )
主要参数：prompt（文本描述，文生图模式下必需，除非指定了非默认风格的内置模板）、reference_path（本地参考图路径）、reference_url（公开 HTTPS 参考图地址）、category（默认 character）、style（默认 default）、model（可选 nanopro 约 25 秒，或 gpt 约 150 秒，默认 nanopro）、count（1–4，默认 1）、aspect_ratio（1:1、3:4、4:3、9:16、16:9，默认按类别自动选择）。
提示词优先级：prompt + category/style（增强）> 仅 prompt > category + style 模板 > category 默认。比例自动选择：角色 3:4，产品/立体模型/图标/游戏资产 1:1，文字/室内/建筑/场景 16:9。
结果交付：不要向用户提供原始 fal.media URL（其 CSP 头限制访问）。应使用每张图的 local_path（如 output/images/xxx.png），并告知用户文件保存在 output/images/，可在工作区文件面板查看。在 Web 渠道可用 Markdown 图片语法内联预览；在 Telegram/微信通过 send_to_telegram 或 send_to_wechat 以 image 类型发送。
适用场景
需要 3D 渲染观感的 2D 图像时，例如 3D 角色、等距场景、3D 图标、建筑与室内效果图、3D 文字特效。与其它图像技能的分工：image-create 面向通用创意图（其含基础 3d 类别，但 image-3d 控制更细）；image-ecommerce 面向电商产品图；image-edit 面向编辑已有图像；image-portrait 面向保留人脸/身份的人像。
限制
- 只生成 3D 风格的 2D 图像（PNG/JPG），不产出 3D 模型文件（.glb、.obj、.fbx、.usdz）。需要实际模型文件时须使用专门的 3D 建模服务（如 Meshy 等）。
- AI 文字渲染不可靠，3D 文字建议保持简短（最多 1–3 个词）。
- 参考图超过 10 MB 会报错，需压缩或缩放。
- 其它错误处理：Unknown model（使用 nanopro 或 gpt）、Unknown category、Unknown style（该类别下无此风格）、File not found（检查路径）、Submit failed（检查 FAL_KEY 并重试）、Generation timed out（重试或改用 nanopro）。
未提供的信息
除上述模型速度与质量的描述外，资料未提供该技能的收费、价格或具体计费方式，暂未提供。