scenario-skyboxes

场景天空盒与 360 全景图

概述

Scenario 提供专用天空盒模型，可生成无缝等距矩形 360 全景图，还提供一款保留接缝的天空盒放大工具。始终使用专用天空盒模型生成，而非通用图像模型：这类模型会强制保证普通文生图输出所缺乏的接缝连续性和极点几何。

连接方式和核心生成流程：请参阅本仓库中的 scenario 技能。如果这里提到的同级技能未包含在你可用的技能中，请让用户安装它 （npx skills add scenario-labs/skills --skill <name>）；若需无人值守地继续，请根据工具架构定义操作，并指出这一缺失。

快速参考

步骤	工具	用途
1	search（target="models", query="skybox", public=true）	发现当前可用的天空盒模型
2	model_schema_get	所选模型的精确参数约定
3	model_run	使用 dry_run=true 估价；使用 wait=false 批量处理
4	jobs_wait	超时时使用 pending_job_ids 重新调用
5	asset_display / asset_download	先在页面中查看，再保存文件

以下模型 ID 和参数信息是在编写本文档时通过实时 search 查询获得的。每次使用时都要重新发现：不同团队可用的模型各不相同，并且模型会不断变化。

• model_scenario-skybox-flux：文本生成 360 全景图，提供风格预设枚举（数量可能变化；请从架构定义中读取），自动校正接缝和极点，可选参考图并提供强度滑块。
• model_scenario-skybox-gpt：在最多 10 张参考图的引导下，通过文本生成 360 全景图；提供质量预设，宽度和高度最高可达 3840 px。
• model_hunyuan-world-image-to-skybox：将一张地点照片转换为无缝 360 天空盒。
• model_sc-upscale-flux-skybox：将天空盒放大 2x 至 8x，同时保留无缝环绕效果。

完整示例：生成、迭代、导出

示例：为游戏场景制作一个风格化森林天空盒。

1. 使用 search，设置 target="models"、query="skybox"、public=true。选择一个文生天空盒模型，例如 model_scenario-skybox-flux。
2. 对该模型调用 model_schema_get。预期会看到 prompt、style、negativePrompt、image、strength、numOutputs、geometryEnforcement、seed 等字段。除非 negativePromptStrength 大于 0，否则 negativePrompt 不起作用。
3. 使用 parameters={"prompt": "ancient pine forest at dawn, mist between trunks, god rays", "style": "cinematic", "numOutputs": 2} 调用 model_run。从架构响应中获取风格预设名称。先设置 dry_run=true 查看运行费用；启动时使用 wait=false。
4. 使用 job_ids=[返回的 job_id] 调用 jobs_wait。其约 180 秒的超时并非错误：使用返回的 pending_job_ids 作为 job_ids 再次调用，绝不要再次调用 model_run。然后对每个输出调用 asset_display。
5. 迭代调整氛围：复制最佳结果的 seed，只更改 style（cinematic、oil-painting、cyberpunk 等）。若要保留构图并改变外观，可将最喜欢的结果作为 image 传入，并使用较低的 strength（0.2 至 0.4）。若要改为通过概念艺术引导氛围，则切换到 model_scenario-skybox-gpt 并传入 referenceImages。
6. 导出：运行 model_sc-upscale-flux-skybox，设置 image=asset_id，并选择能够达到目标的最小 upscaleFactor（放大费用可能是生成费用的好几倍，而且只有输入资源存在后才能运行其 dry_run，因此无法预先估算整个流程的费用）。baseModel 默认为 FLUX.1-dev（风格化）；另有一个基于 Krea 的写实选项。strength 默认为 0.6，会凭空补充细节：若目标是在更高分辨率下保持相同全景图，请调低该值。切换前，请通过 model_schema_get 查看准确的允许值。然后对最终资源调用 asset_download。
7. 免费验证接缝：比较已保存 PNG 最左侧和最右侧的像素列；无缝全景图两列的差异应接近零，而相隔四分之一圈的像素列之间的差异应大一个数量级。

引擎格式说明：Skybox Flux 输出等距柱状全景图；保留默认尺寸（创作时为 1536x768），并根据返回的资源读取实际尺寸，不要自行假定。Skybox GPT 的目录列出等距柱状 2:1、立方体贴图条带 6:1 和立方体贴图十字 4:3 布局，但其架构只公开 width 和 height，因此在依赖立方体贴图布局前，请使用 model_schema_get 确认布局约定。除了平面背景外，同一次搜索还会显示 model_hunyuan-world-skybox-to-splat；另外单独搜索（query="world"）可找到 Marble world 模型。二者都能将完成的全景图转换为可导航的 3D Gaussian splat 场景，这正是 scenario-3d-worlds 技能从头到尾讲解的流程。

常见错误

• 使用通用图像模型提示生成“360 全景图”：边缘无法衔接，极点会出现涂抹。请使用专用天空盒模型。
• 使用通用放大工具进行放大：这会破坏衔接处的连续性。请使用天空盒放大工具。
• 在脚本或文档中硬编码模型 ID：通过 search 重新发现模型；目录会不断变化。
• 试图通过调整 Skybox Flux 的提示词解决接缝或极点失真：应将 geometryEnforcement 调高至大于 0，但仅在确实能看到失真时这样做。
• 使用 Skybox GPT 时，要求宽高比不是 2:1，却期望输出等距柱状图：请保持 2:1（例如 2048x1024），以确保 360 度视图正确。
• 跳过 model_schema_get：天空盒模型包含通用假设无法涵盖的模型专属字段（style、geometryEnforcement、quality）。