调用一个 REST 接口，就能用文字描述或参考照片生成无缝的 360° 全景图——返回永久托管的等距柱状全景图，外加一个可分享的交互式查看器链接。适合应用、游戏、虚拟看房，以及任何需要按需生成 360° 图像的产品流程。
三次 REST 调用，把一句文字描述变成 360° 全景图——不用装 SDK，也不用自己维护任务队列。
向 POST /api/v1/panoramas 发送 prompt 和分辨率（1k、2k 或 4k）。积分会立即被预扣，接口返回 202 Accepted 和任务 id——全景图生成 API 会在后台完成渲染。
每隔几秒调用一次 GET /api/v1/panoramas/{id}，直到 status 变为 succeeded（或 failed）。生成通常需要几十秒，因此这套全景图 API 刻意设计成任务型——即使从超时限制很短的 serverless 函数里调用也很安全。
成功后响应里会带上 image_url（永久托管的等距柱状 PNG）和 viewer_url（可直接分享的交互式 360° 查看器页面）。可以嵌入查看器、下载图片，或者把这个 URL 接入你自己的渲染流程。
用一次 POST 请求创建任务：
curl -X POST https://panoramagenerator.com/api/v1/panoramas \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{"prompt": "sunset over a tropical beach, palm trees", "resolution": "2k"}'手上有真实照片、不想只靠文字描述？同一套全景图生成 API 也接受参考图片，把它扩展成完整的 360° 场景。
先向 POST /api/v1/images 上传最多 3 张参考照片（JPEG、PNG 或 WebP，单张不超过 10MB），接口会返回永久有效的 image_urls。把这些 URL 传入 /api/v1/panoramas 的 image_urls 字段，再配一句可选的简短 prompt 来引导生成方向——参考照片会承担大部分信息量，所以 prompt 可以很短，甚至省略。如果源照片已经托管在你自己的公开 https:// 地址上，也可以跳过上传步骤，直接把地址填进 image_urls。这正是照片转 360° 转换器背后同一套图片转全景图流程，现在以一个纯 REST 接口的形式开放，方便你用脚本或 CI 任务批量把房源照片、产品图或旅行照片转换成全景图，而不必逐张点开浏览器工具。
同一套全景图生成 API，接入任何需要渲染 360° 内容的产品场景。
几秒钟内为房源、展厅或场地生成一张有临场感的 360° 背景图——占位或概念场景不需要摄影师，也不需要 360° 相机。
在构建流程或关卡编辑工具里调用这套 API 按需生成天空盒和背景全景图，再把等距柱状输出接入 Unity、Unreal 或自研渲染器。
把返回的等距柱状图像直接喂给 WebXR 或原生 VR 查看器作为沉浸式环境——很适合在正式拍摄真实 360° 素材之前先做场景原型。
把 AI 360° 图像生成作为自家产品里的一项功能——异步任务 API 加纯 JSON 响应，接入任何后端语言都很简单，不需要浏览器端 SDK。
为产品渲染图配上一个 360° 环境，用在配置器或商品详情页；直接把返回的 viewer_url 当作现成的可嵌入组件使用。
为内容流水线写脚本批量生成——CMS 任务、营销工具，或是需要大量全景图、却不希望人工逐个点击界面的设计系统。
如果一张普通的等距柱状全景图还不是你需要的格式，全景图 API 同时也是另外两条更专精流水线背后的生成核心。
如果你在把这套接口和 Blockade Labs 这类 skybox ai api 做对比：我们的 Skybox 生成器（游戏引擎可用的立方体贴图、无缝 360° 包裹）和 AI HDRI 生成器（面向 Blender、Unreal、Unity 光照的 Radiance .hdr 导出）都构建在同一个 /api/v1/panoramas 接口之上。当你的流程只需要一张 2:1 等距柱状 PNG 加一个可托管的查看器链接时，直接调用全景图 API 即可。Radiance .hdr 导出目前仅在网页版提供，还没有进入 API v1——如果今天就需要 .hdr 文件，请在浏览器里通过 AI HDRI 生成器完成这一步，其余上游环节都可以用全景图 API 完成。
面向游戏引擎的 360° 天空盒，加上浏览器内的立方体贴图转换——适合需要六个面而不是一张等距柱状图的引擎。
同一套生成核心，导出为 Radiance .hdr 容器，用于 Blender、Unreal、Unity 的物理光照——详见 AI HDRI 生成器。
全景图 API 与网页版共用同一份积分余额——没有单独的 API 订阅，也不按调用次数额外开账单。
1K
1024 × 512
4 积分
2K
2048 × 1024
6 积分
4K
3840 × 1920
10 积分
任务创建的瞬间就会预扣积分，如果生成最终失败，积分会自动退回——失败的任务不会让你多花一分钱。随时可以调用 GET /api/v1/credits 查看剩余积分。任意付费方案都会解锁 API Key；当前的积分套餐详见定价页。
真实的 HTTP 状态码，加上稳定、可编程判断的错误码，方便你写出真正有用的重试逻辑，而不是靠猜。
写请求
每个 API Key 每分钟 10 次——适用于 POST /panoramas 和 POST /images。
读请求
每个 API Key 每分钟 60 次——适用于 GET /panoramas/{id} 和 GET /credits。
并发任务
每个账号同时最多 5 个全景图任务处于 processing 状态，该账号下所有 API Key 共享这个上限。
| 状态码 | 错误码 | 含义 |
|---|---|---|
| 400 | invalid_request | JSON 格式错误、image_urls 超过 3 张、图片 URL 不合法、resolution 无效，或没有 image_urls 时 prompt 少于 3 个字符。 |
| 401 | invalid_api_key | 缺少或无效的 Bearer API Key（也可以用 x-api-key 请求头）。 |
| 402 | insufficient_credits | 积分不足以支付所选分辨率——充值后重试。 |
| 404 | not_found | 该账号下不存在这个 id 对应的任务。 |
| 429 | rate_limited | 超过每分钟速率限制——请按 retry-after 响应头里的秒数等待后重试。 |
| 429 | too_many_active_tasks | 该账号已有 5 个任务在处理中——等其中一个完成后再试，这种情况不会返回 retry-after 响应头。 |
| 502 | upstream_error | 上游生成服务出错或超时——可以安全重试。 |
| 500 | internal_error | 服务端出现意外错误——可以带退避策略安全重试。 |
向 POST /api/v1/panoramas 发送一个文字 prompt 和分辨率（1k、2k 或 4k）。接口会立即预扣积分，返回任务 id 和 processing 状态。每隔几秒调用一次 GET /api/v1/panoramas/{id}，直到 status 变为 succeeded，再从响应里读取 image_url 和 viewer_url。上面的快速开始部分有完整的 curl 示例。
有。这套全景图生成 API 把同一个 AI 360° 图像生成引擎以纯 REST 接口的形式开放出来，你可以从后端服务、CI 任务或自动化脚本里直接调用，而不需要通过浏览器界面。如果你不是开发者，只想要一个点一下就能用的 AI 360° 图像生成器，可以直接使用网页版工具360 全景图制作。
先向 POST /api/v1/images 上传最多 3 张参考照片（JPEG、PNG 或 WebP，单张不超过 10MB），拿到永久有效的 image_urls；也可以直接指向你自己的 https:// 照片地址。把 image_urls 传入 POST /api/v1/panoramas，再配一句可选的简短 prompt——照片本身承担大部分信息量，所以 prompt 可以很短甚至省略。这正是照片转 360° 转换器背后的同一套流程，现在也能通过 REST 接口用在脚本和自动化流水线里。
计费方式和网页版完全一样：1K 分辨率 4 积分，2K 6 积分，4K 10 积分。没有单独的 API 订阅——任意付费方案都会解锁 API Key。当前的积分套餐价格见定价页。
每张全景图都是按你选择的分辨率（1K、2K 或 4K）生成的 2:1 等距柱状图像，托管在一个永久的 image_url 上，并附带可分享的交互式 360° 查看器链接 viewer_url。Radiance .hdr 导出目前是网页版独有的功能（见 AI HDRI 生成器），还没有纳入 API v1。
不会。积分在任务创建时预扣，一旦任务状态变为 failed 就会自动退回——你只会为真正生成成功的全景图付费。