360° 全景图生成 API

用 MCP 配置 360° 全景图生成

支持本地 stdio MCP 的 AI 助手可以通过这个独立安装包连接你的全景图账户。包内提供文字生成、参考图片生成、图片上传、任务查询和余额查询，使用你自己的 API Key 调用现有 REST API，无需下载网站源码。生成采用异步任务流程：提交一次，再查询同一个任务，不要为查看进度反复提交提示词。

电脑需要 Node.js 20 或更高版本，以及 npm/npx。前往 API Key 设置 创建密钥；账户须至少有一笔已支付订单。安装包下载不另收费，生成使用你现有的积分余额。

客户端配置

{
  "mcpServers": {
    "panorama": {
      "command": "npx",
      "args": [
        "-y",
        "--package",
        "https://panoramagenerator.com/downloads/panorama-generator-mcp-0.1.0.tgz",
        "panorama-generator-mcp"
      ],
      "env": {
        "PANORAMA_API_KEY": "sk-YOUR_API_KEY"
      }
    }
  }
}

在支持 mcpServers 配置格式的客户端中添加这段配置，把 sk-YOUR_API_KEY 换成自己的密钥后重新连接。npx 会从本站下载安装包并启动。Windows 客户端若无法启动 npx，可改用 npx.cmd。密钥只放在本地配置中，不要发到聊天里；其他客户端可能采用不同的配置格式。

先验证连接，不生成图片

1. 重新连接后，确认能够看到下方五个工具。
2. 调用 get_credit_balance，对照账户里的积分余额。
3. 用有效提示词、resolution 为 1k、max_credits 为 0 调用 generate_panorama_from_text。应返回 budget_exceeded，不创建任务，也不扣积分。

文字生成实测：消耗 4 积分

{
  "prompt": "日出时分宁静的森林木屋，无缝 360 度全景",
  "resolution": "1k",
  "visibility": "private",
  "max_credits": 4
}

使用这段 JSON 调用 generate_panorama_from_text 一次。接口预扣 4 积分并返回 id，随后每隔几秒用该 id 查询 get_panorama_task。storage_status 为 saved 或 saved-no-thumb 时表示图片已持久化，此前可能是临时地址。私人查看器需要作品所属账户登录；任务失败会退回预扣积分。

一次上传支持 1–5 张 JPEG、PNG 或 WebP，单张最多 10 MiB，总计最多 20 MiB；单次生成最多使用 3 个 HTTPS 参考图片地址。可选 max_credits 只限制一次创建，不是账户累计消费限额。当前版本是本地 stdio，不提供远程 MCP 地址、HDR/EXR 导出或引擎插件。创建超时后可能已经扣费，请先检查作品列表，再决定是否重新提交。