Skybox AI 生成的是适合环绕观看的全景环境图。平面预览漂亮，不能证明左右接缝和顶部没有畸变。本文从异步 API 请求到全景检查整理一条路径，示例为“无人物的清晨湖畔”；未调用服务，也不承诺输出分辨率、耗时或套餐可用。
先确定当前样式和账户权限
从官方 Get Skybox Styles 获取可用样式 ID，并把选中的 ID 写入 SKYBOX_STYLE_ID。样式对应模型，模型版本与账户计划会影响可用参数；不要直接照抄文档某个 ID 后假定账户能用。提示词控制一个连续世界，减少大段文字、近距离人物和复杂室内几何。
生成请求完成不等于图片完成
import os, requests
base = "https://backend.blockadelabs.com/api/v1"
h = {"x-api-key": os.environ["SKYBOX_API_KEY"]}
r = requests.post(base+"/skybox", headers=h, json={
"skybox_style_id": int(os.environ["SKYBOX_STYLE_ID"]),
"prompt": "A calm lakeside at sunrise, continuous distant shoreline, no people, no text"}, timeout=60)
r.raise_for_status()
data = r.json()
print("request", data["id"], "status", data["status"])返回 pending 时 file_url 可能为空。官方状态还包括 dispatched、processing、complete、abort 和 error。只有 complete 并有有效资源，才进入结果检查。测试可按请求 ID 查询 GET /imagine/requests/{id}；官方更推荐事件订阅或 webhook，频繁轮询可能触发限制。
在球面视图检查整圈环境
将完成的全景图放入支持等距柱状全景的 360 查看器，左右转一整圈，看地平线是否连续、水面是否突然断开、树是否重复形成接缝。再向上看天空、向下看地面，检查极点拉伸。平面图左右边缘虽不同，球面连接才是主要验收位置。
全景不是可自由移动的三维场景
环境贴图围绕观察点，不能提供真实碰撞、空间测量或近景自由视差。用它做三维场景背景时，应另外建立实际几何与灯光。返回 error/403 先查错误详情、样式和账户权限，不反复付费重试同请求。下一步保存生成提示、样式 ID、状态和环绕验收截图，再导入目标引擎查看。
参考资料
依据 2026-10-03 读取的官方资料整理：官方文档 1；官方文档 2。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/33127.html
