Panorama API でテキストや参考写真から360°パノラマを生成するか、ローカル stdio MCP サーバーで AI アシスタントに接続できます。どちらも同じ API キー、クレジット残高、非同期の生成タスクを使い、2:1の正距円筒画像とビューアー URL を返します。非公開作品のビューアーには所有者のログインが必要です。公開共有には作品を公開設定にする必要があります。
テキストプロンプトを 3 回の REST 呼び出しで 360° パノラマに——インストールする SDK も、自分で管理するキューもありません。
POST /api/v1/panoramas に prompt と解像度(1k、2k、4k)を送信します。クレジットは即座に確保され、エンドポイントは 202 Accepted とタスク id を返します——パノラマ生成 API はレンダリングをバックグラウンドで実行します。
status が succeeded(または failed)になるまで、数秒おきに GET /api/v1/panoramas/{id} を呼び出します。生成には数十秒かかるため、このパノラマ API はあえてタスクベースで設計されています——タイムアウトの短いサーバーレス関数から呼び出しても安全です。
生成が成功したら image_url、viewer_url、storage_status を確認します。画像 URL がまだ一時的な場合があるため、saved または saved-no-thumb になるまで問い合わせてから保存してください。非公開ビューアーには所有者のログインが必要です。公開する予定の作品だけ visibility を public に設定します。
1 回の 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"}'ローカルの stdio MCP に対応する AI アシスタントから、全景画像のアカウントに接続できます。独立したパッケージには、テキストからの生成、参照画像からの生成、画像アップロード、タスク確認、残高確認の機能があります。自分の API キーで既存の REST API を呼び出すため、サイトのソースコードは不要です。生成は非同期です。タスクを一度作成し、そのタスクを確認してください。進捗確認のために再生成する必要はありません。
パソコンに Node.js 20 以上と npm/npx が必要です。API キーの設定でキーを作成してください。作成には支払い済み注文が少なくとも 1 件必要です。パッケージのダウンロードに追加料金はなく、生成にはアカウントのクレジットを使用します。
クライアントの設定
{
"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 を使用してください。キーはローカル設定に保存し、チャットには入力しないでください。クライアントによって設定形式が異なる場合があります。
| ツール | 機能 |
|---|---|
| generate_panorama_from_text | テキストから生成。1k/2k/4k は 4/6/10 クレジット。 |
| generate_panorama_from_images | 1–3 件の HTTPS 画像 URL から生成。プロンプトは任意。 |
| get_panorama_task | 既存タスクを確認し、画像とビューアーの URL を取得。 |
| get_credit_balance | 画像を生成せずにアカウントの残高を確認。 |
| upload_reference_images | 1–5 枚をプレーンな base64 でアップロードし、公開 URL を取得。 |
画像を生成せずに接続を確認する
テキスト生成の実測: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 になるまでは、画像 URL が一時的な場合があります。非公開ビューアーには所有者のログインが必要です。タスクが失敗した場合、確保されたクレジットは返却されます。
アップロードは JPEG、PNG、WebP の 1–5 枚に対応し、1 枚 10 MiB、合計 20 MiB までです。生成に使用できる HTTPS 参照画像 URL は最大 3 件です。max_credits は 1 回の作成の上限であり、アカウント全体の支出上限ではありません。この版はローカル stdio 用で、リモート MCP URL、HDR/EXR 書き出し、エンジンプラグインはありません。作成がタイムアウトしても課金済みの可能性があるため、再送前に作品一覧を確認してください。
プロンプトではなく実際の写真から始めたいですか?同じパノラマ生成 API は参考画像も受け付け、完全な 360° シーンへと拡張します。
POST /api/v1/images には JPEG・PNG・WebP を一度に最大5枚アップロードできます。1枚あたり10 MiB、合計20 MiBまでで、ホストされた image_urls が返ります。POST /api/v1/panoramas には、その HTTPS URL から最大3枚分を選んで渡し、必要ならプロンプトを追加します。アップロード上限と生成時の参考画像上限は別です。5枚アップロードしても、1回の生成に5枚は使えません。自分で公開している HTTPS 画像 URL も利用できます。写真を360°画像に変換もブラウザーで同じ生成処理を使います。
2:1の正距円筒画像をアプリやレンダラーに利用できます。REST API とローカル MCP は同じ生成サービスを使います。キューブマップ変換と HDR 書き出しは別のブラウザーツールで行います。
物件、ショールーム、会場向けに、歩き回れるような臨場感のある 360° 背景を数秒で生成——プレースホルダーやコンセプト用のシーンなら、カメラマンも 360° カメラも不要です。
ビルドパイプラインやレベルデザインツールから API を呼び出してスカイボックスや背景パノラマをオンデマンドで生成し、正距円筒の出力を Unity、Unreal、または自作レンダラーに接続します。
返される正距円筒画像を WebXR やネイティブ VR ビューアにそのまま渡し、没入型環境として利用できます——本格的な 360° 撮影を依頼する前のシーンのプロトタイピングに便利です。
AI 360度画像生成を自社プロダクトの機能として追加——非同期タスク API と素の JSON レスポンスは、どのバックエンド言語にも組み込め、ブラウザ用 SDK は不要です。
商品コンフィギュレーターや商品ページ向けの360°環境を生成します。非公開ビューアー URL には所有者のログインが必要です。顧客にリンクを共有する場合は、一般公開してよいシーンだけを公開設定にしてください。
コンテンツパイプライン向けにバッチ生成をスクリプト化——CMS ジョブ、マーケティングツール、あるいは人手で UI を操作せずに大量のパノラマを必要とするデザインシステムに。
レンダラーに合わせて出力方法を選びます。API と MCP は正距円筒パノラマを返し、ブラウザーツールはキューブマップ変換と HDR 書き出しを提供します。
API とローカル MCP サーバーは2:1の正距円筒画像を生成します。Unity、Unreal、Blender、Web ビューアーの360°背景に利用できます。6面のキューブマップが必要なら、ブラウザーのスカイボックス生成またはキューブマップ生成を使ってください。Radiance .hdr はブラウザーの AI HDRI 生成から書き出せます。API v1 と今回の MCP は HDR/EXR 書き出しやエンジンプラグインを提供しません。画像 URL を保存する前に storage_status を確認し、公開共有する予定のシーンだけを公開設定にしてください。
ゲームですぐ使える 360° スカイボックスと、ブラウザ内でのキューブマップ変換——1 枚の正距円筒画像ではなく 6 つのキューブ面を必要とするエンジン向けです。
同じ生成コアを、Blender、Unreal、Unity の物理ベースライティング向けに Radiance .hdr コンテナとしてエクスポート——詳しくは AI HDRI作成ツール をご覧ください。
REST API と MCP の生成は Web アプリと同じクレジット残高を使います。MCP パッケージのダウンロードに別料金はかかりませんが、画像生成にはクレジットが必要です。
1K
1024 × 512
4 クレジット
2K
2048 × 1024
6 クレジット
4K
3840 × 1920
10 クレジット
テキストと参考画像からの生成は、1K/2K/4Kでそれぞれ4/6/10クレジットを確保します。タスクが失敗すると確保したクレジットが返還されます。残高は GET /api/v1/credits または MCP の get_credit_balance で確認できます。API キーの作成には、アカウントで少なくとも1件の支払い済み注文が必要です。クレジットパックは料金ページをご覧ください。max_credits は1回の MCP 作成予算を制限し、アカウント全体の支出は制限しません。
実際の HTTP ステータスコードに加え、安定した機械可読のエラーコードを返すので、当てずっぽうではなく本物のリトライロジックを組めます。
書き込みリクエスト
API キーごとに 1 分あたり 10 回——POST /panoramas と POST /images に適用されます。
読み取りリクエスト
API キーごとに 1 分あたり 60 回——GET /panoramas/{id} と GET /credits に適用されます。
同時タスク
1 アカウントあたり同時に 5 つのパノラマタスクまで processing 状態にでき、そのアカウントのすべての API キーで共有されます。
| ステータス | コード | 意味 |
|---|---|---|
| 400 | invalid_request | 不正な JSON、image_urls が 3 枚超、無効な画像 URL、無効な resolution、または image_urls なしで prompt が 3 文字未満。 |
| 401 | invalid_api_key | Bearer API キーが欠落または無効(x-api-key ヘッダーも使用可)。 |
| 402 | insufficient_credits | 選択した解像度に対してクレジットが不足——追加購入して再試行してください。 |
| 404 | not_found | 認証済みアカウントに、この id のタスクは存在しません。 |
| 429 | rate_limited | 1 分あたりのレート制限を超過——retry-after ヘッダーで示された秒数だけ待ってから再試行してください。 |
| 429 | too_many_active_tasks | アカウントにすでに 5 つのタスクが処理中です——1 つ完了するまで待ってください。この場合 retry-after ヘッダーは送信されません。 |
| 502 | upstream_error | 生成プロバイダーのエラーまたはタイムアウトです。作成を再送する前に、既存のタスクや作品を確認してください。 |
| 500 | internal_error | 予期しないサーバーエラーです。作成が受け付けられたか確認してから再送してください。読み取りリクエストはバックオフ付きで再試行できます。 |
POST /api/v1/panoramas にテキスト prompt と解像度(1k、2k、4k)を送信します。即座にクレジットを確保し、status が processing のタスク id を返します。status が succeeded になるまで数秒おきに GET /api/v1/panoramas/{id} をポーリングし、レスポンスから image_url と viewer_url を読み取ります。上のクイックスタートに完全な curl の例があります。
はい。このパノラマ生成 API は、同じ AI 360度画像生成エンジンを素の REST エンドポイントとして公開しているので、ブラウザ UI ではなくバックエンド、CI ジョブ、自動化スクリプトから呼び出せます。開発者ではなく、クリックだけで使える AI 360度画像ジェネレーターをお探しなら、ウェブアプリの 360 画像メーカー をお使いください。
POST /api/v1/images で最大5枚をアップロードし、返された HTTPS image_urls から最大3枚分を POST /api/v1/panoramas に渡します。JPEG・PNG・WebP は1枚10 MiB、合計20 MiBまでです。公開 HTTPS 画像 URL を直接渡すこともできます。必要に応じてプロンプトを追加し、シーンを指定してください。
API と MCP は同じ残高から、1Kで4、2Kで6、4Kで10クレジットを使います。MCP パッケージのダウンロードに別料金はかかりません。API キーの作成には少なくとも1件の支払い済み注文が必要です。料金ページでクレジットパックを確認できます。max_credits は1回の MCP 作成予算を制限します。
API と MCP は1K・2K・4Kの2:1正距円筒画像と、image_url、viewer_url、storage_status を返します。ホストされた画像 URL を保存する前に saved または saved-no-thumb を確認してください。非公開ビューアーには所有者のログインが必要で、公開作品には公開ビューアーリンクがあります。API v1 と今回の MCP は HDR/EXR 書き出しに対応していません。
生成タスクが失敗すると、確保されたクレジットが返還されます。タイムアウトや接続エラーだけでは作成失敗と判断できず、サーバーがすでに受け付けている場合があります。同じリクエストを再送する前に、タスクの状態や自分の作品を確認してください。API と MCP は同じ生成・クレジットサービスを使います。
ローカル MCP パッケージをダウンロードし、上の設定を stdio MCP 対応クライアントに追加します。Node.js 20以降と API キーが必要です。generate_panorama_from_text または generate_panorama_from_images を1回呼び出し、返された id で get_panorama_task を問い合わせます。先に get_credit_balance と max_credits 0 の予算チェックで接続を確認してください。
今回のバージョンはローカル stdio MCP サーバーを提供し、ホストされた HTTP・SSE 接続 URL は提供しません。MCP クライアントが npx でパッケージを起動し、パッケージが API キーを使ってオンラインの REST API を呼び出します。リモート MCP URL のみに対応するクライアントは、このローカルパッケージに直接接続できません。
プログラムで 360° パノラマの生成を始めよう
登録時のクレジットで Web アプリの生成を試せます。少なくとも1件の支払い後、REST API やローカル MCP サーバーで使う API キーを作成できます。
料金を見る