Rufe einen einzigen REST-Endpoint auf, um aus einem Text-Prompt oder Referenzfotos ein nahtloses 360° Panorama zu generieren — zurück kommt ein dauerhaft gehostetes equirektangulares Bild plus eine teilbare, interaktive Viewer-URL. Entwickelt für Apps, Games, virtuelle Touren und jede Pipeline, die 360°-Bildgenerierung on demand braucht.
Verwandle einen Text-Prompt in drei REST-Calls in ein 360° Panorama — kein SDK zu installieren, keine Queue selbst zu verwalten.
POST /api/v1/panoramas mit einem Prompt und einer Auflösung (1k, 2k oder 4k). Credits werden sofort reserviert und der Endpoint antwortet mit 202 Accepted und einer Task-ID — die Panorama-Generierungs-API rendert im Hintergrund.
GET /api/v1/panoramas/{id} alle paar Sekunden, bis status auf succeeded (oder failed) umschlägt. Die Generierung dauert 30–60 Sekunden, deshalb ist diese Panorama API bewusst task-basiert — sicher aufrufbar auch aus Serverless-Funktionen mit kurzen Timeouts.
Bei Erfolg enthält die Response image_url — ein dauerhaftes, gehostetes equirektangulares PNG — und viewer_url, eine sofort teilbare, interaktive 360°-Viewer-Seite. Bette den Viewer ein, lade das Bild herunter oder gib die URL in deine eigene Render-Pipeline.
Erstelle eine Task mit einem einzigen POST-Request:
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"}'Lieber von einem echten Foto statt von einem Prompt starten? Dieselbe Panorama-Generierungs-API akzeptiert Referenzbilder und erweitert sie zu einer kompletten 360°-Szene.
Lade mit einem POST auf /api/v1/images bis zu drei Referenzfotos hoch (JPEG, PNG oder WebP, je bis 10MB) und der Endpoint gibt dauerhafte image_urls zurück. Übergib diese URLs als image_urls an /api/v1/panoramas, zusammen mit einem optionalen kurzen Prompt zur Steuerung des Ergebnisses — das Referenzfoto trägt das meiste Signal, der Prompt kann also knapp ausfallen oder ganz entfallen. Das Quellfoto liegt schon öffentlich und per https:// erreichbar? Überspring den Upload und richte image_urls direkt darauf. Das ist dieselbe Foto-zu-Panorama-Pipeline hinter unserem Foto-zu-360°-Konverter, als schlichter REST-Call bereitgestellt — so wandelst du einen Stapel Immobilienfotos, Produktaufnahmen oder Reisebilder per Skript oder CI-Job in Panoramen um, statt dich durch ein Browser-Tool zu klicken.
Eine Panorama-Generierungs-API, eingebunden in alles, was in deinem Produkt 360°-Inhalte rendert.
Generiere in Sekunden einen begehbar wirkenden 360°-Hintergrund für ein Inserat, einen Showroom oder eine Location — kein Fotograf und keine 360°-Kamera nötig für Platzhalter- oder Konzeptszenen.
Rufe die API aus einer Build-Pipeline oder einem Level-Design-Tool auf, um Skyboxen und Hintergrund-Panoramen on demand zu generieren, und verdrahte die equirektangulare Ausgabe dann in Unity, Unreal oder deinen eigenen Renderer.
Gib das zurückgelieferte equirektangulare Bild direkt in einen WebXR- oder nativen VR-Viewer als immersive Umgebung — praktisch, um Szenen zu prototypen, bevor du echte 360°-Fotografie beauftragst.
Füge AI 360°-Bildgenerierung als Feature in dein eigenes Produkt ein — die async Task API und schlichte JSON-Responses passen in jede Backend-Sprache, kein Browser-SDK nötig.
Generiere eine 360°-Umgebung rund um ein Produkt-Render für einen Konfigurator oder eine Produktseite und binde die gehostete viewer_url als fertiges Embed ein.
Automatisiere die Batch-Generierung per Skript für eine Content-Pipeline — ein CMS-Job, ein Marketing-Tool oder ein Design-System, das viele Panoramen braucht, ohne dass ein Mensch ein UI anfasst.
Wenn ein schlichtes equirektangulares Panorama nicht ganz das Format ist, das du brauchst: Die Panorama API ist zugleich der Generierungs-Core hinter zwei spezialisierteren Pipelines.
Wenn du das mit einer Skybox AI API wie Blockade Labs vergleichst — derselbe /api/v1/panoramas Endpoint ist die Grundlage, auf der sowohl unser dedizierter Skybox Generator (game-engine-fertige Cubemaps und nahtlose 360°-Wraps) als auch unser AI HDRI Generator (Radiance-.hdr-Export für die Beleuchtung in Blender, Unreal und Unity) aufbauen. Rufe die Panorama API direkt auf, wenn ein 2:1 equirektangulares PNG und eine gehostete Viewer-URL alles sind, was deine Pipeline braucht. Der Radiance-.hdr-Export ist aktuell ein reines Web-App-Feature — noch nicht Teil von API v1 — für eine .hdr-Datei heute also über den AI HDRI Generator im Browser generieren und die Panorama API für alles davor nutzen.
Game-fertige 360°-Skyboxen und Cubemap-Konvertierung im Browser, für Engines, die sechs Cube-Faces statt eines equirektangularen Bildes erwarten.
Derselbe Generierungs-Core, exportiert als Radiance-.hdr-Container für physikalisch basierte Beleuchtung in Blender, Unreal und Unity — siehe AI HDRI Generator.
Die Panorama API rechnet gegen dasselbe Credit-Guthaben ab wie die Web-App — kein separater API-Plan, keine Rechnung pro Call.
1K
1024 × 512
4 Credits
2K
2048 × 1024
6 Credits
4K
3840 × 1920
10 Credits
Credits werden im Moment der Task-Erstellung reserviert und automatisch erstattet, falls die Generierung am Ende failed — eine kaputte Task kostet dich nie etwas. Prüfe dein Restguthaben jederzeit mit GET /api/v1/credits. API Keys gibt es in jedem kostenpflichtigen Plan; aktuelle Credit-Bundles siehe Preise.
Echte HTTP-Statuscodes plus stabile, maschinenlesbare Error Codes, damit du echte Retry-Logik baust statt zu raten.
Write-Requests
10 / Minute pro API Key — gilt für POST /panoramas und POST /images.
Read-Requests
60 / Minute pro API Key — gilt für GET /panoramas/{id} und GET /credits.
Gleichzeitige Tasks
5 Panorama-Tasks gleichzeitig in processing pro Account, gemeinsam für alle API Keys dieses Accounts.
| Status | Code | Bedeutung |
|---|---|---|
| 400 | invalid_request | Fehlerhaftes JSON, mehr als 3 image_urls, eine ungültige Bild-URL, eine ungültige resolution oder ein prompt unter 3 Zeichen ohne image_urls. |
| 401 | invalid_api_key | Fehlender oder ungültiger Bearer API Key (der x-api-key Header funktioniert ebenfalls). |
| 402 | insufficient_credits | Nicht genug Credits für die angeforderte Auflösung — nachkaufen und erneut versuchen. |
| 404 | not_found | Für diese id existiert im authentifizierten Account keine Task. |
| 429 | rate_limited | Rate Limit pro Minute überschritten — nach den Sekunden im retry-after Header erneut versuchen. |
| 429 | too_many_active_tasks | Der Account hat bereits 5 Tasks in processing — warte, bis eine fertig ist; es wird kein retry-after Header gesendet. |
| 502 | upstream_error | Der vorgelagerte Generierungsanbieter hat einen Fehler geliefert oder ist in einen Timeout gelaufen — sicher wiederholbar. |
| 500 | internal_error | Unerwarteter Serverfehler — sicher mit Backoff wiederholbar. |
Sende einen POST-Request an /api/v1/panoramas mit einem Text-Prompt und einer Auflösung (1k, 2k oder 4k). Er reserviert sofort Credits und liefert eine Task-ID mit status processing zurück. Polle GET /api/v1/panoramas/{id} alle paar Sekunden, bis status succeeded ist, und lies dann image_url und viewer_url aus der Response. Der Quickstart-Abschnitt oben enthält ein vollständiges curl-Beispiel.
Ja. Die Panorama-Generierungs-API stellt dieselbe AI-360°-Bildgenerierungs-Engine als schlichten REST-Endpoint bereit, sodass du sie aus einem Backend, CI-Job oder Automatisierungsskript aufrufen kannst statt über ein Browser-UI. Wenn du als Nicht-Entwickler eher einen klickbaren AI-360°-Bildgenerator suchst, nutze die Web-App unter 360-Grad-Bild-Generator.
Lade bis zu 3 Referenzfotos mit POST /api/v1/images hoch (JPEG, PNG oder WebP, je bis 10MB), um dauerhafte image_urls zu erhalten, oder zeige direkt auf deine eigene https:// Foto-URL. Übergib image_urls an POST /api/v1/panoramas zusammen mit einem optionalen kurzen Prompt — das Foto trägt das meiste Signal, der Prompt kann also knapp sein oder entfallen. Das ist dieselbe Pipeline hinter dem Foto-zu-360°-Konverter, verfügbar als REST-Call für Skripte und Pipelines.
Die API rechnet dieselben Credits ab wie die Web-App: 4 Credits bei 1K, 6 bei 2K und 10 bei 4K Auflösung. Es gibt kein separates API-Abo — jeder kostenpflichtige Plan schaltet API Keys frei. Aktuelle Preise der Credit-Bundles siehe Preise.
Jedes Panorama ist ein 2:1 equirektangulares Bild in deiner gewählten Auflösung — 1K, 2K oder 4K — gehostet unter einer dauerhaften image_url, plus eine teilbare viewer_url für den interaktiven 360°-Viewer. Der Radiance-.hdr-Export ist vorerst ein separates, reines Web-App-Feature (siehe AI HDRI Generator) und nicht Teil von API v1.
Nein. Credits werden bei der Task-Erstellung reserviert und automatisch erstattet, sobald der status einer Task auf failed wechselt — du zahlst nur für Panoramen, die tatsächlich erfolgreich generiert werden.
Leg los: 360°-Panoramen per API generieren
Gratis-Credits bei der Anmeldung lassen dich zuerst die Web-App testen; jeder kostenpflichtige Plan schaltet API Keys für die Panorama-Generierungs-API frei.
Preise ansehen