3D Cog - Turn Ideas Into 3D Models
3D model generation from text descriptions or reference images.
Most 3D generation tools need a single, perfectly composed reference image. CellCog takes anything — a text description, a rough sketch, a product photo, even a spreadsheet of 50 items — and handles the entire pipeline: reasoning about what you need, generating optimized reference images, and converting them into production-ready GLB files.
How to Use
For your first CellCog task in a session, read the cellcog skill for the full SDK reference — file handling, chat modes, timeouts, and more.
OpenClaw (fire-and-forget):
CODEBLOCK0
All agents except OpenClaw (blocks until done):
from cellcog import CellCogClient
client = CellCogClient(agent_provider="openclaw|cursor|claude-code|codex|...")
result = client.create_chat(
prompt="[your task prompt]",
task_label="my-task",
chat_mode="agent",
)
print(result["message"])
What Makes This Different
Any Input → 3D
The power of CellCog isn't image-to-3D — everyone does that. The power is any-to-any.
| What You Send | What CellCog Does | What You Get |
|---|
| Text description | Reasons about the object → generates optimized reference image → converts to 3D | Production-ready GLB |
| Rough sketch |
Enhances into a clean, detailed reference → converts to 3D | Production-ready GLB |
| Product photo | Assesses quality, enhances if needed → converts to 3D | Production-ready GLB |
| High-quality concept art | Converts directly to 3D | Production-ready GLB |
| List of 10 items | Generates 10 reference images → converts all to 3D | 10 GLB files |
Batch Generation
Need 10 low-poly weapons for your RPG? 20 furniture models for your room designer? 50 product models for your e-commerce catalog?
One prompt. Multiple 3D models. CellCog's agents generate each reference image with the right composition, angle, and detail level — then convert each to a textured 3D model.
CODEBLOCK2
What You Can Create
Game Assets
- - Characters: Heroes, NPCs, enemies, bosses
- Weapons: Swords, bows, staffs, shields, guns
- Props: Furniture, treasure chests, potions, tools
- Vehicles: Cars, spaceships, boats, mounts
- Environment pieces: Trees, rocks, buildings, bridges
Product Visualization
- - E-commerce 3D viewers: Let customers rotate and inspect products
- Product prototypes: Visualize designs before manufacturing
- Packaging mockups: 3D packaging for marketing materials
AR/VR Objects
- - AR filters and objects: Place 3D objects in real environments
- VR environments: Furnish virtual spaces with custom objects
- Interactive experiences: Objects users can inspect and interact with
3D Printing
- - Figurines and miniatures: Tabletop gaming pieces, collectibles
- Functional objects: Custom tools, brackets, cases
- Architectural models: Building miniatures, terrain pieces
Education & Training
- - Anatomical models: Organs, skeletal systems, molecular structures
- Historical artifacts: Museum-quality digital replicas
- Engineering models: Mechanical parts, assembly visualizations
Output Format
All 3D models are delivered as GLB files (binary glTF) — the universal web standard for 3D:
- - Supported by Unity, Unreal, Godot, Three.js, Babylon.js
- Works in web browsers via
<model-viewer> or Three.js - Compatible with Blender, Maya, 3ds Max for further editing
- Includes textures and materials in a single file
Chat Mode for 3D
| Scenario | Recommended Mode |
|---|
| Single 3D object from a clear description or image | INLINECODE1 |
| Batch generation (5-20 objects from a list) |
"agent" |
| Complex game asset pipeline with style consistency |
"agent team" |
Use "agent" for most 3D work. It handles everything from single objects to batch generation.
Use "agent team" when you need cross-asset consistency — like generating a full set of fantasy weapons that all share the same art style, or building a complete room of furniture that matches a design language.
Example Prompts
Single object from description:
"Create a 3D model of a steampunk pocket watch with exposed brass gears, an etched glass face, and a chain attachment. GLB format, high detail."
From a reference image:
"Convert this product photo into a 3D model for our online store:
INLINECODE6
Output as GLB, enable PBR materials for realistic rendering."
Batch generation:
"Generate 3D models for these 8 pieces of modern furniture:
- 1. Minimalist sofa (3-seater, light gray)
- Round coffee table (walnut wood, glass top)
- Floor lamp (arc style, brass finish)
- Bookshelf (5 tiers, oak wood)
- Dining chair (Scandinavian, white)
- Side table (concrete, cylindrical)
- Desk (standing desk, white with birch legs)
- TV console (low profile, dark walnut)
All low-poly (~15,000 polygons), with PBR materials. GLB format."
From a rough sketch:
"Here's my rough sketch of a robot character:
INLINECODE7
Turn this into a polished 3D model. It's a friendly service robot — round body, simple limbs, LED face display. Style: Overwatch/Pixar clean 3D. Output as GLB."
Game asset set:
"I'm building a dungeon crawler. Create 3D models for these dungeon props:
- - Wooden treasure chest (open and closed variants)
- Iron torch holder with flame
- Stone altar with carved runes
- Wooden barrel (intact and broken)
- Skull pile
Style: Dark fantasy, hand-painted textures. Low poly for mobile game (~8,000 polygons each)."
Tips for Better 3D Models
- 1. Be specific about materials: "brushed aluminum", "aged leather", "polished marble" — CellCog uses these to generate better reference images and textures.
- 2. Specify your target platform: "low-poly for mobile game" vs "high-detail for cinematic render" changes the approach completely.
- 3. Send reference images when possible: Even imperfect references give CellCog a head start over pure text descriptions.
- 4. For batch jobs, describe style once: "All in a cohesive hand-painted fantasy style" keeps your assets consistent.
- 5. Request PBR materials for realism: If you need metallic, roughness, and normal maps — say so. Essential for game engines and realistic rendering.
If CellCog is not installed
Run /cellcog-setup (or /cellcog:cellcog-setup depending on your tool) to install and authenticate.
OpenClaw users: Run clawhub install cellcog instead.
Manual setup: pip install -U cellcog and set CELLCOG_API_KEY. See the cellcog skill for SDK reference.
3D Cog - 将创意转化为3D模型
从文本描述或参考图像生成3D模型。
大多数3D生成工具需要一张单一、构图完美的参考图像。而CellCog可以处理任何输入——文本描述、粗略草图、产品照片,甚至包含50个项目的电子表格——并处理整个流程:推理你的需求、生成优化的参考图像,并将其转换为可直接投入生产的GLB文件。
使用方法
在会话中首次使用CellCog任务时,请阅读cellcog技能以获取完整的SDK参考——包括文件处理、聊天模式、超时设置等。
OpenClaw(即发即忘模式):
python
result = client.create_chat(
prompt=[你的任务提示],
notifysessionkey=agent:main:main,
task_label=my-task,
chat_mode=agent,
)
除OpenClaw外的所有代理(阻塞直到完成):
python
from cellcog import CellCogClient
client = CellCogClient(agent_provider=openclaw|cursor|claude-code|codex|...)
result = client.create_chat(
prompt=[你的任务提示],
task_label=my-task,
chat_mode=agent,
)
print(result[message])
独特之处
任意输入 → 3D输出
CellCog的强大之处不在于图像转3D——这谁都能做。它的强大在于任意到任意的转换。
| 你发送的内容 | CellCog的处理方式 | 你得到的结果 |
|---|
| 文本描述 | 推理对象特征 → 生成优化参考图像 → 转换为3D | 可直接投入生产的GLB |
| 粗略草图 |
增强为清晰详细的参考图 → 转换为3D | 可直接投入生产的GLB |
| 产品照片 | 评估质量,必要时增强 → 转换为3D | 可直接投入生产的GLB |
| 高质量概念图 | 直接转换为3D | 可直接投入生产的GLB |
| 10个物品的列表 | 生成10张参考图像 → 全部转换为3D | 10个GLB文件 |
批量生成
需要为你的RPG游戏制作10个低多边形武器?为你的室内设计工具制作20个家具模型?为你的电商目录制作50个产品模型?
一个提示。多个3D模型。CellCog的代理会为每个参考图像生成正确的构图、角度和细节级别——然后将每个图像转换为带纹理的3D模型。
python
prompt =
为以下5种奇幻武器创建3D模型(GLB格式):
- 1. 带有蓝色水晶剑刃的附魔长剑
- 刻有符文铭文的矮人战锤
- 装饰着活藤蔓的精灵弓
- 剑刃带有烟雾效果的暗影匕首
- 带有金色旭日锤头的圣光钉锤
低多边形(每个约10,000个多边形),游戏就绪,带PBR材质。
你可以创建的内容
游戏资产
- - 角色:英雄、NPC、敌人、Boss
- 武器:剑、弓、法杖、盾牌、枪械
- 道具:家具、宝箱、药水、工具
- 载具:汽车、飞船、船只、坐骑
- 环境组件:树木、岩石、建筑、桥梁
产品可视化
- - 电商3D查看器:让客户旋转和检查产品
- 产品原型:在制造前可视化设计
- 包装效果图:用于营销材料的3D包装
AR/VR对象
- - AR滤镜和对象:在真实环境中放置3D对象
- VR环境:用自定义对象装饰虚拟空间
- 交互体验:用户可以检查和互动的对象
3D打印
- - 手办和微缩模型:桌面游戏棋子、收藏品
- 功能性对象:自定义工具、支架、外壳
- 建筑模型:建筑微缩模型、地形组件
教育与培训
- - 解剖模型:器官、骨骼系统、分子结构
- 历史文物:博物馆级数字复制品
- 工程模型:机械零件、装配可视化
输出格式
所有3D模型均以GLB文件(二进制glTF)形式交付——这是3D领域的通用网络标准:
- - 支持Unity、Unreal、Godot、Three.js、Babylon.js
- 通过或Three.js在网页浏览器中运行
- 兼容Blender、Maya、3ds Max进行进一步编辑
- 纹理和材质包含在单个文件中
3D聊天模式
| 场景 | 推荐模式 |
|---|
| 根据清晰描述或图像生成单个3D对象 | agent |
| 批量生成(从列表中生成5-20个对象) |
agent |
| 需要风格一致性的复杂游戏资产管线 | agent team |
大多数3D工作使用agent模式。 它处理从单个对象到批量生成的所有任务。
当你需要跨资产一致性时使用agent team模式——比如生成一套共享相同艺术风格的完整奇幻武器,或构建一个符合设计语言的完整房间家具。
示例提示
根据描述生成单个对象:
创建一个蒸汽朋克怀表的3D模型,带有外露的黄铜齿轮、蚀刻玻璃表面和链条附件。GLB格式,高细节。
根据参考图像:
将这张产品照片转换为3D模型,用于我们的在线商店:
FILE>/photos/sneakerproduct.png
输出为GLB格式,启用PBR材质以实现逼真渲染。
批量生成:
为以下8件现代家具生成3D模型:
- 1. 极简沙发(3座,浅灰色)
- 圆形咖啡桌(胡桃木,玻璃桌面)
- 落地灯(弧形设计,黄铜饰面)
- 书架(5层,橡木)
- 餐椅(斯堪的纳维亚风格,白色)
- 边桌(混凝土材质,圆柱形)
- 书桌(站立式,白色配桦木桌腿)
- 电视柜(低矮型,深胡桃木)
全部低多边形(约15,000个多边形),带PBR材质。GLB格式。
根据粗略草图:
这是我画的机器人角色草图:
FILE>/sketches/robotconcept.jpg
将其转化为精致的3D模型。这是一个友好的服务机器人——圆形身体、简单四肢、LED面部显示屏。风格:守望先锋/皮克斯风格的干净3D。输出为GLB。
游戏资产集:
我正在制作一款地牢探险游戏。为以下地牢道具创建3D模型:
- - 木质宝箱(打开和关闭两种变体)
- 带火焰的铁制火把架
- 刻有符文的石制祭坛
- 木桶(完整和破损两种状态)
- 骷髅堆
风格:黑暗奇幻,手绘纹理。低多边形,适用于手机游戏(每个约8,000个多边形)。
制作更好3D模型的技巧
- 1. 明确指定材质:拉丝铝、做旧皮革、抛光大理石——CellCog会利用这些信息生成更好的参考图像和纹理。
- 2. 指定目标平台:手机游戏用低多边形与电影级渲染用高细节会完全改变处理方式。
- 3. 尽可能发送参考图像:即使是不完美的参考图像,也比纯文本描述能让CellCog更好地起步。
- 4. 批量任务时,一次性描述风格:全部采用统一的手绘奇幻风格能保持资产的一致性。
- 5. 需要真实感时请求PBR材质:如果你需要金属度、粗糙度和法线贴图——请明确说明。这对游戏引擎和真实感渲染至关重要。
如果CellCog未安装
运行/cellcog-setup(或根据你的工具运行/cellcog:cellcog-setup)进行安装和认证。
OpenClaw用户: 请运行clawhub install cellcog。
手动安装: pip install -U cellcog并设置CELLCOGAPIKEY。请参阅cellcog技能以获取SDK参考。