在通过 Layer MCP 生成或编辑游戏/娱乐资产时，按…

通过 Layer MCP 生成或编辑图像、视频、3D mesh、音频等游戏/娱乐资产时，用 Forge 或 Workflows 并控制 Creative Units 花费。

适用场景

解决思路

1. 理解 Layer 用统一的 model-agnostic 请求形态生成图像、视频、3D mesh 和音频，工作以 Creative Units (CUs) 计价并计费到 workspace。
2. 通过 streamable HTTP 与 OAuth 连接 MCP 服务端 https://mcp.app.layer.ai/mcp；在首次生成前每个会话调用一次 get_instructions，在首次 Forge 运行前调用 get_forge_instructions。
3. 默认使用 Forge 直接运行单个模型并完全控制参数；当用户指定 Workflow，或该任务已有可复用的多步骤 Blueprint 管道时，改用 Workflows（参见 layer-workflows）。
4. 作用域：调用 list_workspaces 获取 workspace_id；大多数工具需要它；用户有多个工作区时询问用哪个，否则取最近活跃的工作区。
5. 选择模型：调用 list_base_models，传入 filter.use_case，取第一个结果，默认 sort 为 Layer 精选顺序。
6. 检查模型：对选中的模型调用 get_base_model，查看单模型契约，包括是否需要在 prompt 中加触发词以及支持哪些宽高比。
7. 上传文件：本地字节用 request_file_upload_url，它返回两步可续传上传的签名 URL 和 file_id；只有当文件已在公开 http(s) URL 时才用 upload_file；必须先生成前上传，绝不生成后补。
8. 估价：执行前每次调用 estimate_forge_price；它免费，返回价格、估价后的余额以及将使用的模型（包括是否 auto_picked）。
9. 超过 20 CUs 时必须询问用户并等待明确同意；服务器规定此阈值不可协商，不要提高，也不要允许用户为会话提高；用短表呈现：生成什么、哪个工作区付费、价格对比余额。
10. 按每次运行守门：每个 estimate 只给一次运行定价；对计划中的多次运行序列（如四帧循环或六个图标集），先估第一项并呈现整个序列的总价，开始前让用户一次性同意花费，避免逐次询问或每项低于阈值而漏问。
11. 有些工作区有 allow_negative_balance，表示运行不会被阻止，但不表示免费，绝不能作为跳过花费确认的理由。
12. 执行：调用 execute_forge，返回 inference_id 和 poll_interval_seconds。
13. 轮询：按返回的 poll_interval_seconds（通常 10s）调用 get_forge_run，直到 COMPLETE，然后展示资产 URL；不要用固定 sleep。
14. batch_size 范围为 1 到 16，默认 4；它只生成同一 prompt 的变体；四个不同 sprite 是四个 prompt，因此应发起四次运行，而不是一次 batch_size: 4。
15. 示例流程（四张手绘等距建筑 sprite）：list_workspaces 取 workspace id；list_base_models 用 filter.use_case: text_to_image 取第一个；get_base_model 查看触发词和宽高比；estimate_forge_price 传 base_model_id、prompt、batch_size: 4；若 7 CUs 对余额 900 低于阈值则无需确认；execute_forge 传相同参数加 session_name 让四个 sprite 分组；get_forge_run 按 inference_id 和 poll_interval_seconds 轮询至 COMPLETE 后展示资产 URL。
16. 不要硬编码 base_model_id；目录受工作区限制且会变化，硬编码会在别处失败并报 MODEL_NOT_FOUND；每次都重新发现。
17. filter.use_case 是主要过滤器，覆盖任务形态：text_to_image、image_editing、inpainting、reframing、multi_angle、split_into_layers、upscaling、background_removal、vectorization、text_to_video、image_to_video、video_editing、video_extend、text_to_3d、image_to_3d、remesh、retexture、rig、animate、segment、text_to_speech、sound_effects、music。
18. 仅当任务确实需要时才用 filter.capabilities 缩小范围；它是布尔对象，不是名称列表，例如 filter.capabilities: {tileability: true}；只设置需要的字段并省略其他，因为 false 也是过滤器而非默认值。
19. filter.capabilities 字段包括 tileability、inpainting、outpainting、negative_prompt、image_editing、generate_audio、lipsync、loop、fixed_duration、music、instrumental、sound_effect、character_pose、structure、outline、square、portrait_9_16、landscape_16_9、multiple_aspect_ratios。
20. 用 filter.max_price 限制花费；如果过滤器没有结果，说明太窄，应放宽过滤条件，而不是凭空编造模型。
21. 文件引用：把 file_id 值按正确类型传入 guidance_files；类型包括 init_image、reference_image、pose、depth、canny、lineart、scribble、face、first_frame、last_frame、init_video、reference_video、init_audio、reference_audio、init_mesh、texture_image。
22. 已完成运行的输出资产已经带 file_id，直接喂给下一次运行；重新上传已生成资产永远是错误。
23. 训练风格：调用 list_reference_sets 获取工作区的训练风格；以 reference_sets: [{set_id, weight}] 传入，最多 10 个，weight 0 到 2，默认 1.0。
24. 当传入 reference sets 且没有 base_model_id 时，服务器会挑选能应用它们的模型，这通常正是想要的：精选排名是任务匹配，不是参考集匹配；参见 layer-reference-sets。
25. 降级是静默的：reference_sets_degraded 和 reference_sets_warning 会在 estimate、execute 和 poll 返回；降级运行仍会成功并且仍会花费 CUs；当某个 set 没有应用时，说明是哪个以及为什么；绝不把降级的 set 报告为已应用。
26. 路由：根据用户需求选择 sibling skill：静态图像或 prompt 不理想 -> layer-image；修改已有图像 -> layer-image-editing；视频或镜头运动 -> layer-video；网格、绑定或动画 -> layer-3d；音乐、音效或语音 -> layer-audio；角色、环境、图标或游戏 UI -> layer-game-assets；像素画、sprite sheets 或 walk cycle -> layer-pixel-art；无缝重复纹理 -> layer-textures；整套统一风格或训练风格 -> layer-reference-sets；保存的多步骤管道 -> layer-workflows；把片段剪成最终视频 -> layer-video-timeline；提交前的方向、moodboard 或 storyboard -> layer-art-direction；交付前评判一批资产 -> layer-quality。
27. 如果 routing 中提到的 sibling skill 不可用，请用户安装 npx skills add layerai/skills --skill <name>；无人值守时，从工具 schema 继续并标记缺口。
28. 常见错误：不要凭记忆断言 base_model_id；不要未估价就执行，也不要未明确同意就花费超过 20 CUs；不要固定 sleep 而不用 poll_interval_seconds；不要把 batch_size 当作一次运行获得 N 个不同资产的方法；不要把降级 reference set 报告为已应用；不要重新上传已有 file_id 的资产；不要把 allow_negative_balance 当作跳过花费守门的许可。
29. 错误处理 UNAUTHENTICATED：OAuth 流程未完成，把用户送到其 MCP 客户端设置。
30. 错误处理 MODEL_NOT_FOUND：用 list_base_models 重新发现，绝不再猜。
31. 错误处理 INSUFFICIENT_BALANCE：引导用户到 Layer app 购买 credits。
32. 错误处理 RATE_LIMITED：并发运行过多，等待或用 cancel_inference 取消一个。
33. 错误处理 FEATURE_DISABLED：工作区缺少该功能，指向应用内支持，不要推测如何启用。

适用边界 · 注意事项

• 不适用于不使用 Layer 平台、没有 Layer workspace/OAuth 或无法消费 Creative Units 的场景。
• 只做连接、认证或 REST 等价调用时，优先看 layer-connect-mcp 和 layer-generate-assets，而不是把本技能当完整接入指南。
• 任务不需要生成或编辑图像、视频、3D mesh、音频等娱乐资产时，不要套用本流程。