Erzeuge 360°-Panoramen aus Text oder Referenzfotos über die Panorama API oder verbinde einen KI-Assistenten über den lokalen stdio-MCP-Server. Beide Wege nutzen denselben API-Schlüssel, dasselbe Guthaben und asynchrone Aufgaben. Du erhältst ein equirektangulares 2:1-Bild und einen Viewer-Link. Private Viewer erfordern die Anmeldung des Eigentümers; öffentliches Teilen setzt ein öffentliches Panorama voraus.
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.
Lies nach erfolgreicher Generierung image_url, viewer_url und storage_status. Die Bild-URL kann noch temporär sein: Warte auf saved oder saved-no-thumb, bevor du die gehostete URL speicherst. Private Viewer erfordern die Anmeldung des Eigentümers. Wähle public nur für Panoramen, die du öffentlich teilen möchtest.
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"}'Verbinden Sie einen KI-Assistenten mit lokaler stdio-MCP-Unterstützung mit Ihrem Panorama-Konto. Das eigenständige Paket bietet Textgenerierung, Generierung mit Referenzbildern, Bilduploads, Aufgabenstatus und Guthabenabfragen. Es nutzt Ihren API-Schlüssel und dieselbe REST-API; der Quellcode der Website wird nicht benötigt. Die Generierung läuft asynchron: Erstellen Sie eine Aufgabe und fragen Sie ihren Status ab, statt den Prompt erneut abzusenden.
Sie benötigen Node.js 20 oder neuer sowie npm/npx auf Ihrem Computer. Erstellen Sie einen Schlüssel in den API-Schlüssel-Einstellungen. Ihr Konto muss mindestens eine bezahlte Bestellung haben. Der Download kostet nichts zusätzlich; die Generierung nutzt Ihr vorhandenes Guthaben.
Client-Konfiguration
{
"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"
}
}
}
}Fügen Sie diesen Eintrag in einem Client ein, der das mcpServers-Format unterstützt. Ersetzen Sie sk-YOUR_API_KEY durch Ihren Schlüssel und verbinden Sie sich erneut. npx lädt das Paket von dieser Website und startet es. Unter Windows kann npx.cmd erforderlich sein. Speichern Sie den Schlüssel nur in der lokalen Konfiguration, nicht im Chat. Andere Clients verwenden möglicherweise ein anderes Format.
| Tool | Funktion |
|---|---|
| generate_panorama_from_text | Panorama aus Text erstellen; 1k/2k/4k kosten 4/6/10 Credits. |
| generate_panorama_from_images | Panorama aus 1–3 HTTPS-Bildadressen erstellen, optional mit Prompt. |
| get_panorama_task | Status einer Aufgabe sowie Bild- und Viewer-URLs abrufen. |
| get_credit_balance | Kontoguthaben ohne Bildgenerierung abfragen. |
| upload_reference_images | 1–5 Bilder als reines Base64 hochladen und öffentliche URLs erhalten. |
Verbindung ohne Bildgenerierung prüfen
Textgenerierung testen: 4 Credits
{
"prompt": "Eine ruhige Waldhütte bei Sonnenaufgang, nahtloses 360-Grad-Panorama",
"resolution": "1k",
"visibility": "private",
"max_credits": 4
}Rufen Sie generate_panorama_from_text einmal mit diesem JSON auf. Die API reserviert 4 Credits und liefert eine id. Fragen Sie get_panorama_task mit dieser id alle paar Sekunden ab. Bis storage_status saved oder saved-no-thumb lautet, kann die Bild-URL temporär sein. Private Ansichten erfordern die Anmeldung des Eigentümers. Fehlgeschlagene Aufgaben erstatten die reservierten Credits.
Pro Upload sind 1–5 JPEG-, PNG- oder WebP-Bilder erlaubt: höchstens 10 MiB pro Bild und 20 MiB insgesamt. Eine Generierung akzeptiert bis zu 3 HTTPS-Referenzbilder. max_credits begrenzt nur eine Erstellung, nicht die gesamten Kontoausgaben. Diese Version verwendet lokales stdio und bietet keine entfernte MCP-URL, HDR/EXR-Exporte oder Engine-Plugins. Eine Erstellung kann trotz Zeitüberschreitung berechnet worden sein; prüfen Sie zuerst Ihre Werke.
Lieber von einem echten Foto statt von einem Prompt starten? Dieselbe Panorama-Generierungs-API akzeptiert Referenzbilder und erweitert sie zu einer kompletten 360°-Szene.
POST /api/v1/images akzeptiert bis zu 5 JPEG-, PNG- oder WebP-Dateien pro Upload, höchstens 10 MiB je Datei und 20 MiB insgesamt, und liefert gehostete image_urls. Übergib höchstens 3 dieser HTTPS-URLs mit einem optionalen Prompt an POST /api/v1/panoramas. Upload-Limit und Referenzbild-Limit sind verschieden: 5 hochgeladene Dateien erlauben keine Generierung mit 5 Referenzen. Alternativ kannst du eigene öffentliche HTTPS-Bild-URLs verwenden. Der Foto-zu-360°-Konverter nutzt denselben Generierungsablauf im Browser.
Nutze das equirektangulare 2:1-Bild in deiner App oder deinem Renderer. REST API und lokale MCP-Tools verwenden denselben Dienst; Cubemap-Konvertierung und HDR-Export erfolgen separat im Browser.
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.
Erzeuge eine 360°-Umgebung für einen Produktkonfigurator oder eine Produktseite. Private Viewer-URLs erfordern die Anmeldung des Eigentümers. Veröffentliche deshalb nur Szenen, die öffentlich sichtbar sein sollen, bevor du Viewer-Links mit Kunden teilst.
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.
Wähle den Ausgabeweg für deinen Renderer: API und MCP liefern equirektangulare Panoramen; Browser-Tools übernehmen Cubemap-Konvertierung und HDR-Export.
Die API und der lokale MCP-Server erzeugen ein equirektangulares 2:1-Bild als 360°-Hintergrund für Unity, Unreal, Blender oder einen Web-Viewer. Für sechs Würfelflächen nutze den Skybox Generator oder Cubemap Generator im Browser. Radiance-.hdr-Dateien exportierst du mit dem AI HDRI Generator. API v1 und diese MCP-Version bieten weder HDR/EXR-Export noch Engine-Plugins. Prüfe storage_status, bevor du eine Bild-URL speicherst, und veröffentliche nur Szenen, die du öffentlich teilen möchtest.
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.
Generierungen über REST API und MCP nutzen dasselbe Guthaben wie die Web-App. Der MCP-Paketdownload kostet nicht extra; die Bilderzeugung verbraucht weiterhin Credits.
1K
1024 × 512
4 Credits
2K
2048 × 1024
6 Credits
4K
3840 × 1920
10 Credits
Text- und Referenzbild-Generierungen reservieren 4/6/10 Credits für 1K/2K/4K. Fehlgeschlagene Aufgaben erstatten die reservierten Credits. Prüfe dein Guthaben mit GET /api/v1/credits oder dem MCP-Tool get_credit_balance. Für einen API-Schlüssel muss dein Konto mindestens eine bezahlte Bestellung haben. Credit-Pakete findest du unter Preise. max_credits begrenzt eine einzelne MCP-Erstellung, nicht die gesamten Kontoausgaben.
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 Generierungsanbieter meldet einen Fehler oder Timeout. Prüfe vorhandene Aufgaben oder Werke, bevor du erneut eine Erstellung anfragst. |
| 500 | internal_error | Unerwarteter Serverfehler. Prüfe vor einer erneuten Erstellung, ob die Anfrage angenommen wurde; Leseanfragen können mit Backoff wiederholt werden. |
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 mit POST /api/v1/images bis zu 5 Dateien hoch und übergib dann höchstens 3 zurückgegebene HTTPS-image_urls an POST /api/v1/panoramas. JPEG-, PNG- und WebP-Dateien dürfen jeweils bis zu 10 MiB groß sein, insgesamt höchstens 20 MiB pro Upload. Eigene öffentliche HTTPS-Bild-URLs sind ebenfalls möglich. Ein optionaler Prompt steuert die Szene.
API und MCP verwenden dasselbe Guthaben: 4 Credits für 1K, 6 für 2K und 10 für 4K. Der MCP-Paketdownload kostet nicht extra. Für einen API-Schlüssel ist mindestens eine bezahlte Bestellung erforderlich. Credit-Pakete stehen unter Preise; max_credits begrenzt das Budget einer einzelnen MCP-Erstellung.
API und MCP liefern ein equirektangulares 2:1-Bild in 1K, 2K oder 4K sowie image_url, viewer_url und storage_status. Warte auf saved oder saved-no-thumb, bevor du die gehostete Bild-URL speicherst. Private Viewer erfordern die Anmeldung des Eigentümers; öffentliche Panoramen haben öffentliche Viewer-Links. API v1 und diese MCP-Version bieten keinen HDR/EXR-Export.
Fehlgeschlagene Generierungsaufgaben erstatten die reservierten Credits. Ein Timeout oder Verbindungsfehler allein beweist keinen Fehlschlag: Der Server könnte die Erstellung bereits angenommen haben. Prüfe die Aufgabe oder deine Werke, bevor du dieselbe Anfrage erneut sendest. API und MCP verwenden denselben Generierungs- und Credit-Dienst.
Lade das lokale MCP-Paket herunter und füge die Konfiguration oben in einen Client mit stdio-MCP-Unterstützung ein. Du benötigst Node.js 20 oder neuer und einen API-Schlüssel. Rufe generate_panorama_from_text oder generate_panorama_from_images einmal auf und frage danach get_panorama_task mit der zurückgegebenen id ab. Teste zuerst get_credit_balance und die Budgetprüfung mit max_credits 0.
Diese Version bietet einen lokalen stdio-MCP-Server, keine gehostete HTTP- oder SSE-Verbindungs-URL. Dein MCP-Client startet das Paket auf deinem Computer mit npx. Das Paket ruft die gehostete REST API mit deinem Schlüssel auf. Ein Client, der ausschließlich Remote-MCP-URLs akzeptiert, kann sich nicht direkt mit diesem lokalen Paket verbinden.
Leg los: 360°-Panoramen per API generieren
Teste die Web-App mit deinen Start-Credits. Nach mindestens einer bezahlten Bestellung kannst du einen API-Schlüssel für REST-Aufrufe oder den lokalen MCP-Server erstellen.
Preise ansehen