技能介绍

它解决的问题

从文字描述、参考图或多视角图到可用 3D 玩具模型，传统流程要并行处理概念设计、多视图校验、3D 建模和打印输出，回流成本高。这个技能把这条链路收敛到一套 API：先用 toy_generator_design_draft 生成玩具设计草图与多视角参考图，再用 toy_generator_task_create 创建 3D 生成任务，最后用 toy_generator_task_poll 轮询任务直到 success 或 failed。

工作方式与关键步骤

它支持 figurine、stuffed-toy、3d-printing、game-assets、architecture 等模板，其中 3d-printing 面向可打印玩具设计，输出可直接使用的 3D 模型文件。asset_size 决定目标尺寸；文档明确给出的 Figurine 选项是 small（5cm，W:10mm, D:10mm, H:50mm）、standard（10cm，W:20mm, D:20mm, H:100mm）、premium（30cm，W:30mm, D:30mm, H:300mm）。生成商量可用 mode 控制复杂度，basic、standard、advanced 分别对应基础、标准和高复杂度，demo 只返回预定义结果，适合调试，不建议用于生产。

设计草稿接口可用 prompt 和 images 生成多视角参考图，返回 reference_images、final_image_url、overall_image.front/right/back 和 share_url。随后创建任务时，可继续传 images、prompt，或传 multi_view；使用多视角生成时 front 必填，right、back 可选。3D 供应商通过 provider_model_id 选择，如 tripo/tripo 或 meshy/meshy，也可传 model 使用具体模型。任务创建后返回 task_id 与 share_url，轮询时继续使用 task_id，最终任务结果会提供模型预览，文档示例格式包括 .glb、.obj。

适用边界与注意点

它适合快速从不确定概念迭代到 3D 资产，尤其适合需要多视角参考图和玩具模板约束的场景。但它不是切片器或打印工艺验证器：模型是否适合实际打印，仍需检查尺寸、壁厚、悬空结构、支撑和打印机参数。多视角输入依赖正背视角一致性；demo 模式不可作为交付结果。调用前需要准备 OneKey Gateway access key，默认供应商和模型可用参数由上游服务支持情况决定。