mcpField
3
3d-model-generation

3d-model-generation

github.com/eachlabs创意与媒体441.3k 次安装今天更新
代码仓库

关于 3d-model-generation

3d-model-generation 是使用 each::sense 根据文字描述或参考图创建 3D 资产的技能，支持游戏、产品可视化、建筑等用途，并提供格式和迭代指引。

主要功能

  1. 01文字转 3D 与图像转 3D
  2. 02生成人物、产品、场景和建筑
  3. 03生成 PBR 纹理贴图
  4. 04支持多种 3D 输出格式
  5. 05支持迭代及批量生成资产

适用场景

  1. 01制作游戏资产
  2. 02创建产品可视化模型
  3. 03生成建筑场景
  4. 04根据参考图制作带纹理的 3D 模型

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/eachlabs/skills --skill 3d-model-generation

安装后在 Claude Code 中输入/3d-model-generation确认已加载。

附带文件references/SSE-EVENTS.md

详细介绍

3D 模型生成

使用 each::sense 生成可用于生产的 3D 模型。这项技能可根据文本描述或参考图像创建 3D 资产，适用于游戏、电子商务、建筑、产品可视化等领域。

功能

  • 文本转 3D：根据自然语言描述生成 3D 模型
  • 图像转 3D：将 2D 图像转换为 3D 模型
  • 角色模型：创建人形和生物类 3D 角色
  • 产品模型：适用于电子商务的产品 3D 资产
  • 环境/场景：生成 3D 环境和景观
  • 游戏资产：低多边形和风格化的游戏就绪模型
  • 家具：室内设计和家居装饰 3D 模型
  • 载具：汽车、飞机和交通工具 3D 资产
  • 建筑：建筑物、构筑物和建筑元素
  • PBR 纹理：为 3D 模型生成基于物理的渲染纹理

快速开始

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a 3D model of a medieval treasure chest with gold trim and iron locks"}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

输出格式

格式扩展名用途
GLB.glb通用格式，适用于 Web/AR/VR、Unity、Unreal
GLTF.gltfWeb 应用、three.js
OBJ.obj旧版支持、3D 打印
FBX.fbx动画、游戏引擎
USDZ.usdzApple AR Quick Look

用例示例

1. 文本转 3D 模型生成
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a 3D model of a futuristic sci-fi helmet with glowing blue visor and matte black finish. High detail, suitable for game assets."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
2. 图像转 3D
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Convert this product image into a 3D model. Maintain accurate proportions and surface details for e-commerce use."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "image_urls": ["https://example.com/product-image.jpg"]
  }'
3. 角色 3D 模型
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a 3D character model of a fantasy warrior elf with ornate silver armor, long pointed ears, and a flowing cape. T-pose, game-ready topology."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
4. 产品 3D 模型
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a 3D model of a premium wireless headphone. Matte black with rose gold accents, leather ear cushions. High detail for product visualization and AR try-on."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
5. 环境/场景 3D
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a 3D environment scene of a Japanese zen garden with a stone pathway, bamboo fence, koi pond, and cherry blossom trees. Stylized low-poly aesthetic for mobile games."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
6. 游戏资产 3D 模型
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a low-poly 3D game asset pack: a wooden crate, barrel, torch, and treasure chest. Stylized textures, optimized for real-time rendering, under 5000 triangles each."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "eco"
  }'
7. 家具 3D 模型
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a 3D model of a mid-century modern armchair. Walnut wood frame with teal velvet upholstery. Realistic materials for interior design visualization and AR placement."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
8. 载具 3D 模型
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a 3D model of a vintage 1960s muscle car. Cherry red metallic paint, chrome details, whitewall tires. High detail exterior suitable for automotive visualization."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
9. 建筑 3D 模型
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a 3D architectural model of a modern minimalist house. Two stories, large glass windows, flat roof, concrete and wood exterior. Include surrounding landscape."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
10. 3D 模型的 PBR 纹理生成
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Generate PBR texture maps for weathered bronze metal. Include albedo, normal, roughness, metallic, and ambient occlusion maps. 2K resolution, tileable."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

最佳实践

模型质量
  • 描述具体：说明材质类型（金属、木材、织物）、表面效果（哑光、亮面）和风格（写实、风格化、低多边形）
  • 说明用途：注明模型是否用于游戏（经过优化）、AR/VR、3D 打印或可视化
  • 提供比例参考：在适用时描述尺寸，以确保比例合适
拓扑指南
  • 适用于游戏：要求优化多边形数量和干净的拓扑
  • 适用于动画：角色指定 T 姿，并要求提供合适的边循环
  • 3D 打印：要求网格水密且几何体为流形
纹理质量
  • PBR 材质：要求指定纹理贴图（反照率、法线、粗糙度、金属度、AO）
  • 分辨率：根据用途指定纹理分辨率（1K、2K、4K）
  • 可平铺：为重复表面要求无缝/可平铺纹理

3D 生成提示词技巧

创建 3D 模型时，请在提示词中包含以下信息：

  1. 物体描述：物体是什么？具体说明类型和风格
  2. 材质：物体由哪些材质构成？（金属、木材、塑料、织物）
  3. 表面效果：哑光、亮面、拉丝、风化等
  4. 风格：写实、风格化、低多边形、卡通、照片级真实
  5. 用途：游戏资产、产品可视化、AR、3D 打印
  6. 技术规格：需要时说明多边形数量、纹理分辨率
示例提示词结构
"Create a 3D model of [object description] with [materials/colors].
Style: [realistic/stylized/low-poly].
Use case: [game/AR/visualization/printing].
[Additional requirements like texture maps, polygon count, etc.]"

模式选择

生成前询问用户：

“你想要速度快、成本低，还是质量高？”

模式最适合速度质量
max最终生产资产、主打模型、产品图片较慢最高
eco快速原型、概念探索、批量生成较快良好

多轮 3D 模型迭代

使用 session_id 迭代 3D 模型：

# Initial model
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a 3D model of a fantasy sword with dragon motifs"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "sword-project-001"
  }'

# Iterate based on feedback
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Add more intricate engravings on the blade and make the dragon head on the hilt more prominent"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "sword-project-001"
  }'

# Request variations
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create 2 more variations: one with ice theme and one with fire theme"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "sword-project-001"
  }'

批量生成资产

为项目生成多个 3D 资产：

# Asset 1 - Props
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a 3D model of a medieval wooden tavern table with benches"}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "eco",
    "session_id": "medieval-tavern-pack"
  }'

# Asset 2 - Environment piece
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a 3D model of a stone fireplace with crackling fire effect placeholder"}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "eco",
    "session_id": "medieval-tavern-pack"
  }'

# Asset 3 - Decorative
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create 3D models of tavern decorations: hanging lantern, wall-mounted deer head, and wooden mug"}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "eco",
    "session_id": "medieval-tavern-pack"
  }'

错误处理

错误原因解决方案
Failed to create prediction: HTTP 422余额不足在 eachlabs.ai 充值
内容策略违规内容违规调整提示词以符合内容策略
超时生成内容复杂将客户端超时时间设置为至少 10 分钟
图片 URL 无效图片无法访问确保图片 URL 可公开访问

相关技能

  • each-sense - 核心 API 文档
  • product-photo-generation - 产品摄影和可视化
  • image-generation - 用于参考图片的 2D 图像生成

评论

支持 Markdown