scenario-rodin

Scenario Rodin 3D

概述

Rodin Hyper3D 是 Deemos Technology 在 Scenario 上的 3D 系列，按成员选择模式：图像转 3D 和文本转 3D 均提供完整模型和 Fast 变体，而 Bang! 会将完成的网格拆分为多个部分。使用 search 发现这些模型，并将 model_schema_get 视为契约：不同通道的概念一致，但参数名称不同。

关于连接和核心工作流程，请参阅本仓库中的 scenario 技能；关于与模型无关的 3D 工作，请参阅 scenario-3d 技能。如果这里提到的同级技能不在你可用的技能中，请让用户安装它（npx skills add scenario-labs/skills --skill <name>）；如果无法联系用户，请根据工具架构继续操作，并指出这一缺失。

快速参考

根据任务选择成员：

任务	成员	必需输入
图像转 3D（img23d）	Gen-2.5 或 Fast	images
文本转 3D（txt23d）	Gen-2.5 Text to 3D 或 Fast	prompt
拆分并重新贴图（3d23d）	Bang!	model + image

即使只有一张静态图，images 也必须是数组（编写时最多支持 5 张）；其中每张图片都必须是同一主体的一个视角，不能代表不同的概念。图像成员的 prompt 是可选的：留空时，Rodin 会根据图片生成提示词。通用生成器参数：qualityMeshOption（将拓扑和多边形预算合并为一个枚举字符串，例如“18K Quad”）、material（PBR、Shaded、All、None）、textureDelight（去除烘焙光照）、TAPose（设为 true 时，会将角色摆成 T 姿或 A 姿以便绑定；架构不会指定采用哪种姿势）、seed（0 到 65535）。

通道决定参数方言

完整通道和 Fast 通道用不同参数表达相同概念，因此载荷无法在两个通道之间原样通用。编写时，完整通道的 tier 范围为 Gen-2.5-Extreme-Low 到 Gen-2.5-Extreme-High（Extreme High 的费用是基础价格的两倍）；HighPack 以字符串形式放在 addons 中（对于 Quad 网格，面数约增加 16 倍）；geometryInstructMode: "creative" 会放宽解释方式；isSymmetric 控制对称性；isMicro 仅在 Extreme High 下生效。Fast 通道的 tier 仅支持 Gen-2.5-Minimum、Gen-2.5-Extreme-Low 和 Gen-2.5-Low，价格固定；highPack 是布尔值；enableCreativeMode 可增强生成的稳健性，同时保持一致性；网格上限为 20K，默认值为 Auto。两个通道中的 HighPack 都意味着 4K 纹理和高多边形几何，且需额外付费：批量操作前，请先对确切载荷运行 dry_run。文本成员不支持仅适用于图像的开关（useOriginalAlpha、previewRender）。

Bang! 需要完成的网格

Bang! 属于 3D 转 3D：它接收现有 3D 资源作为 model，并接收参考 image（编写时两者均为必需项，prompt 可用于提供可选引导），将网格拆分为语义上有意义的部分，并在同一轮处理中重新生成各部分的材质。strength（2 到 12，默认值为 5）控制拆分的精细程度；数值越高，拆分的部分越多；这里的 material 默认为 PBR，而非 All；resolution 中的“Basic”为 2K，“High”为 4K。编写时，处理需要几分钟，且每个资源的费用高于默认生成器运行：与其他成员一样，先运行 dry_run。

示例：使用多角度视图静帧制作可直接绑定的角色

1. 使用 search，设置 target="models"、query="rodin"、public=true。根据任务匹配能力 （此处为 img23d，仅使用提示词时选 txt23d，制作低成本草稿时选 Fast），例如 model_rodin-hyper3d-v2-5 （编写时查询到的有效结果：每次会话都要重新发现）。
2. 使用该 ID 调用 model_schema_get：先查看枚举值、默认值和上限。
3. 使用 upload_asset 上传多角度视图静帧（参见 scenario 技能），获取资源 ID。
4. 使用对应的 model_id 调用 model_run，设置 dry_run=true，并传入 parameters={"images": ["asset_front", "asset_side", "asset_back"], "prompt": "stylized adventurer, clean silhouette", "tier": "Gen-2.5-Medium", "qualityMeshOption": "18K Quad", "material": "PBR", "textureDelight": true, "TAPose": true}； 更改任何 tier 或 HighPack 设置后，都要重新估算。
5. 使用 wait=false 重新运行，然后用返回的 job ID 调用 jobs_wait；超时后再次调用时传入 pending_job_ids。完整通道的任务需要数分钟；超时不代表失败，也绝不能因此再次调用 model_run。
6. 使用 asset_display 查看网格，然后使用 asset_download 导入引擎（详情参见 scenario-3d 技能）。

常见错误

• images 中只传入一个字符串：单张静帧也要写成 ["asset_x"]。
• 跨通道复用载荷：addons: "HighPack" 与布尔值 highPack 不同，geometryInstructMode 与 enableCreativeMode 不同，tier 枚举互不兼容。
• 在 Fast 通道请求 Medium 或 High 等级，或 500K 网格：其枚举值最高仅支持 Low 和 20K。
• 在完整通道上将 isMicro 设置为低于 Extreme High：这不会产生任何效果。
• 将图像作为 model 传给 Bang!：model 是 3D 资源；image 用于指导重新生成纹理。
• 随意填写枚举字符串：值必须完全匹配，如 "Gen-2.5-Medium"、"18K Quad"，不能写成 "medium" 或 "18k quad"。