1 つの REST エンドポイントを呼び出すだけで、テキストプロンプトや参考写真からシームレスな 360° パノラマを生成——恒久的にホストされる正距円筒（equirectangular）画像と、共有できるインタラクティブなビューア URL を受け取れます。アプリ、ゲーム、バーチャルツアー、そしてオンデマンドで 360° 画像生成を必要とするあらゆるパイプライン向けに設計されています。
テキストプロンプトを 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（恒久的にホストされる正距円筒 PNG）と viewer_url（すぐに共有できるインタラクティブな 360° ビューアページ）が含まれます。ビューアを埋め込む、画像をダウンロードする、URL を自前のレンダリングパイプラインに渡す、いずれも可能です。
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"}'プロンプトではなく実際の写真から始めたいですか？同じパノラマ生成 API は参考画像も受け付け、完全な 360° シーンへと拡張します。
POST /api/v1/images に参考写真を最大 3 枚アップロードすると（JPEG、PNG、WebP、各 10MB まで）、エンドポイントは恒久的に有効な image_urls を返します。それらの URL を /api/v1/panoramas の image_urls に渡し、生成方向を調整したい場合は任意の短い prompt を添えます——参考写真がほとんどの情報を担うため、prompt は短くても、省略しても構いません。すでに元写真を公開の https:// でアクセス可能な場所にホストしていますか？その場合はアップロードを省略し、image_urls にその URL を直接指定できます。これは写真を360度パノラマに変換するツールの裏側にあるのと同じ写真パノラマ変換パイプラインを、素の REST 呼び出しとして公開したものです。ブラウザツールを 1 枚ずつクリックする代わりに、物件写真・商品写真・旅行写真をスクリプトや CI ジョブからまとめてパノラマに変換できます。
1 つのパノラマ生成 API を、あなたのプロダクトで 360° コンテンツをレンダリングするあらゆる場所につなぎます。
物件、ショールーム、会場向けに、歩き回れるような臨場感のある 360° 背景を数秒で生成——プレースホルダーやコンセプト用のシーンなら、カメラマンも 360° カメラも不要です。
ビルドパイプラインやレベルデザインツールから API を呼び出してスカイボックスや背景パノラマをオンデマンドで生成し、正距円筒の出力を Unity、Unreal、または自作レンダラーに接続します。
返される正距円筒画像を WebXR やネイティブ VR ビューアにそのまま渡し、没入型環境として利用できます——本格的な 360° 撮影を依頼する前のシーンのプロトタイピングに便利です。
AI 360度画像生成を自社プロダクトの機能として追加——非同期タスク API と素の JSON レスポンスは、どのバックエンド言語にも組み込め、ブラウザ用 SDK は不要です。
商品のレンダリング画像の周囲に 360° 環境を生成し、コンフィギュレーターや商品ページに利用。返される viewer_url をそのまま埋め込み用パーツとして使えます。
コンテンツパイプライン向けにバッチ生成をスクリプト化——CMS ジョブ、マーケティングツール、あるいは人手で UI を操作せずに大量のパノラマを必要とするデザインシステムに。
普通の正距円筒パノラマではフォーマットが少し足りないという場合、パノラマ API はさらに 2 つの専用パイプラインの背後にある生成コアでもあります。
この API を Blockade Labs のような skybox ai api と比較しているなら：私たちの専用 Skybox 生成ツール（ゲームエンジンで使えるキューブマップとつなぎ目のない 360° 連結）と AI HDRI作成ツール（Blender、Unreal、Unity のライティング向け Radiance .hdr エクスポート）は、どちらも同じ /api/v1/panoramas エンドポイントの上に構築されています。パイプラインに必要なのが 2:1 の正距円筒 PNG とホスト型ビューア URL だけなら、パノラマ API を直接呼び出してください。Radiance .hdr エクスポートは現在ウェブアプリ専用の機能で、まだ API v1 には含まれていません——今すぐ .hdr ファイルが必要な場合は、ブラウザで AI HDRI作成ツールから生成し、その手前の工程はすべてパノラマ API で行ってください。
ゲームですぐ使える 360° スカイボックスと、ブラウザ内でのキューブマップ変換——1 枚の正距円筒画像ではなく 6 つのキューブ面を必要とするエンジン向けです。
同じ生成コアを、Blender、Unreal、Unity の物理ベースライティング向けに Radiance .hdr コンテナとしてエクスポート——詳しくは AI HDRI作成ツール をご覧ください。
パノラマ API はウェブアプリと同じクレジット残高から課金されます——別途の API プランも、呼び出しごとの請求もありません。
1K
1024 × 512
4 クレジット
2K
2048 × 1024
6 クレジット
4K
3840 × 1920
10 クレジット
タスクが作成された瞬間にクレジットが確保され、生成が failed に終わった場合は自動的に返金されます——失敗したタスクで料金が発生することは一切ありません。残高はいつでも GET /api/v1/credits で確認できます。API キーはすべての有料プランで利用できます。現在のクレジットバンドルは料金ページをご覧ください。
実際の 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 に参考写真を最大 3 枚アップロードして（JPEG、PNG、WebP、各 10MB まで）恒久的に有効な image_urls を取得するか、自分の https:// 写真 URL を直接指定します。image_urls を POST /api/v1/panoramas に渡し、任意で短い prompt を添えます——写真がほとんどの情報を担うので、prompt は短くても省略しても構いません。これは写真を360度パノラマに変換するツールの裏側と同じパイプラインで、スクリプトやパイプライン向けに REST 呼び出しとして利用できます。
API はウェブアプリと同じクレジットで課金されます：1K で 4 クレジット、2K で 6 クレジット、4K で 10 クレジット。別途の API サブスクリプションはありません——有料プランなら API キーが解放されます。現在のクレジットバンドルの価格は料金ページをご覧ください。
すべてのパノラマは、選択した解像度（1K、2K、4K）の 2:1 正距円筒画像で、恒久的にホストされる image_url が付き、インタラクティブな 360° ビューア用の共有できる viewer_url も付きます。Radiance .hdr エクスポートは今のところ別機能でウェブアプリ専用（AI HDRI作成ツールを参照）であり、API v1 には含まれません。
いいえ。クレジットはタスク作成時に確保され、タスクの status が failed になった瞬間に自動的に返金されます——実際に成功したパノラマ分だけが課金されます。