HY-World 2.1 Panorama API
Erzeugt aus einem Textprompt ein hochauflösendes, nahtloses360-Grad-Panorama für explorierbare3D-Welten.
Tencent: HY-World2.1 Panorama ist ein spezialisiertes Bildgenerierungsmodell innerhalb der Hunyuan World-Familie. Es erzeugt aus einem einzelnen Textprompt genau ein hochauflösendes360-Grad-Panorama im equirektangularen Format. Die Szenenanordnung bleibt über die gesamte Kugel hinweg kohärent und nahtlos. Prompts sind auf600 Zeichen begrenzt; die Kontextgröße beträgt4K.
Das Modell eignet sich für virtuelle Rundgänge, Skyboxes, den Aufbau von Spielwelten und die schnelle Entwicklung von Umgebungs-Assets. Die erzeugten3D-Assets können in Unity, Unreal Engine und Blender importiert werden. Außerdem dienen die Panoramen als Grundlage für Kameraplanung sowie für die Erweiterung zu navigierbaren3D-Umgebungen, Augmented-Reality-Inhalte und Robotik-Simulationen mit visueller Navigation.
Die Panoramaerzeugung ist Teil einer größeren Pipeline für explorierbare3D-Welten, die auch Meshes, Gaussian splattings und Punktwolken erzeugen kann. Für HY-World2.1 Panorama selbst liegen keine spezifischen Benchmarkwerte vor; die verfügbaren Werte beziehen sich auf verwandte Systeme.
Aktualisiert:
MODELL-ID
hy-world-2.1-panorama- Eingabe
- text
- Ausgabe
- image
Highlights
- Nahtlose360-Grad-Szenen
- 600 Zeichen pro Prompt
- 4K-Kontext
- Import in Unity
- Import in Unreal Engine
- Import in Blender
Anbieter
Vergleichen Sie die API-Preise verschiedener Anbieter. Wählen Sie einen Anbieter aus, um alle Kosten und Bedingungen zu sehen.
| Verfügbarkeit | |
|---|---|
Historische Daten sind keine Live-Statusprüfung. Fehlende Daten bedeuten keinen Ausfall.
Benchmarks
- 41.43
Tanks-and-Temples
F1-Wert des verwandten Systems HY-World2.0
- 51.27
MipNeRF360
Wert des verwandten Systems HY-World2.0
- 0.492
Rotation error
Grad für WorldStereo2.0, verglichen mit0.762 Grad in Version1
- 0.968
Translation error
Meter für WorldStereo2.0, verglichen mit1.245 Meter in Version1
Werte wie vom Modellanbieter veröffentlicht.
Schnellstart
Senden Sie einen Bildauftrag, fragen Sie den Status ab und speichern Sie die Bilder. Die Beispiele verwenden curl und die Python-3-Standardbibliothek.
POST https://openapi.felo.ai/api/v1/images/generations
1API-Schlüssel hinterlegen
Erstellen Sie einen Schlüssel in Ihrem Konto bei der Felo API Platform und legen Sie ihn als Umgebungsvariable ab.
export FELO_API_KEY="YOUR_API_KEY"2Erste Anfrage senden
Optionale Werte hängen vom Modell ab und werden hier nicht vorgegeben. Prüfen Sie sie im Playground. Felder stehen neben model und prompt, ohne input-Hülle.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
"model": "hy-world-2.1-panorama"
}'3Aufgabe abfragen
Die Antwort enthält task_id. Bei queued oder running alle 3 Sekunden abfragen; bei succeeded, failed oder interrupted stoppen. Maximale Wartezeit: 30 Minuten. Mit created.json können Sie denselben Auftrag ohne erneute Übermittlung weiter abfragen.
python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen
task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800
while task["status"] in ("queued", "running"):
if time.monotonic() >= deadline:
raise TimeoutError(f"Keep task_id={task_id} to resume polling")
time.sleep(3)
with urlopen(Request(url, headers=headers), timeout=60) as response:
task = json.load(response)
if task.get("task_id") != task_id or task.get("kind") != "image":
raise ValueError("Unexpected task response")
print(task["status"])
if task["status"] != "succeeded":
raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY4Ausgabe herunterladen
Nach Erfolg outputs aus task.json speichern. Unterstützt werden HTTPS-URLs, URL-Objekte und b64_json. Signierte URLs zeitnah herunterladen; dafür ist kein API-Schlüssel nötig.
python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen
task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}
for index, output in enumerate(task["outputs"], 1):
item = output if isinstance(output, dict) else {}
url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
mime = item.get("media_type") or "image/png"
if url and url.startswith("https://"):
with urlopen(url, timeout=60) as response:
data = response.read()
mime = response.headers.get_content_type()
elif url and url.startswith("data:image/") and ";base64," in url:
header, encoded = url.split(",", 1)
mime = header[5:].split(";", 1)[0]
data = base64.b64decode(encoded, validate=True)
elif item.get("b64_json"):
data = base64.b64decode(item["b64_json"], validate=True)
else:
raise ValueError("Unrecognized image output")
path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
path.write_bytes(data)
print(path)
PYUnterstützte Parameter
- n
Lieber die vollständige Referenz?
API-Referenz →Häufige Fragen
Was ist HY-World 2.1 Panorama?
Tencent: HY-World2.1 Panorama ist ein spezialisiertes Bildgenerierungsmodell innerhalb der Hunyuan World-Familie. Es erzeugt aus einem einzelnen Textprompt genau ein hochauflösendes360-Grad-Panorama im equirektangularen Format. Die Szenenanordnung bleibt über die gesamte Kugel hinweg kohärent und nahtlos. Prompts sind auf600 Zeichen begrenzt; die Kontextgröße beträgt4K. Das Modell eignet sich für virtuelle Rundgänge, Skyboxes, den Aufbau von Spielwelten und die schnelle Entwicklung von Umgebungs-Assets. Die erzeugten3D-Assets können in Unity, Unreal Engine und Blender importiert werden. Außerdem dienen die Panoramen als Grundlage für Kameraplanung sowie für die Erweiterung zu navigierbaren3D-Umgebungen, Augmented-Reality-Inhalte und Robotik-Simulationen mit visueller Navigation. Die Panoramaerzeugung ist Teil einer größeren Pipeline für explorierbare3D-Welten, die auch Meshes, Gaussian splattings und Punktwolken erzeugen kann. Für HY-World2.1 Panorama selbst liegen keine spezifischen Benchmarkwerte vor; die verfügbaren Werte beziehen sich auf verwandte Systeme.
Wie wird die Nutzung abgerechnet?
Ihre Rechnung hängt vom genutzten Anbieter, seinen Preisen und Ihrer Nutzung ab. Längere Eingaben oder andere Bedingungen können andere Preise haben. Abrechnung nach den tatsächlichen Generierungskosten. Den endgültigen Betrag finden Sie in Ihrer Rechnung.
Welche Eingaben und Ausgaben unterstützt das Modell?
Es akzeptiert Texteingaben und erzeugt ein Bildausgabeformat. Jede Anfrage liefert ein einziges hochauflösendes360-Grad-Panorama.
Wie lang darf ein Prompt sein?
Prompts sind auf600 Zeichen begrenzt. Die Kontextgröße beträgt4K.
Für welche Aufgaben eignet sich HY-World2.1 Panorama?
Es eignet sich für virtuelle Rundgänge, Skyboxes, World-Building, Spielumgebungs-Assets, Augmented-Reality-Inhalte und Robotik-Training.
Was unterscheidet es von anderen Modellen der Familie?
HY-World2.1 Panorama ist auf die Erzeugung eines einzelnen nahtlosen360-Grad-Panoramas spezialisiert. Es dient als Panorama-Stufe innerhalb einer größeren Pipeline für explorierbare3D-Welten.
Über welche Schnittstelle ist das Modell verfügbar?
Es wird auf OpenRouter ausschließlich von Tencent Cloud bereitgestellt und ist über eine OpenAI-kompatible API verfügbar.