Felo API PlatformFelo API Platform
Zurück zu den Modellen

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

1 Anbieter

Vergleichen Sie die API-Preise verschiedener Anbieter. Wählen Sie einen Anbieter aus, um alle Kosten und Bedingungen zu sehen.

Anbieter · Preisdetails
Verfügbarkeit

Benchmarks

  • Tanks-and-Temples

    F1-Wert des verwandten Systems HY-World2.0

    41.43
  • MipNeRF360

    Wert des verwandten Systems HY-World2.0

    51.27
  • Rotation error

    Grad für WorldStereo2.0, verglichen mit0.762 Grad in Version1

    0.492
  • Translation error

    Meter für WorldStereo2.0, verglichen mit1.245 Meter in Version1

    0.968

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")
PY

4Ausgabe 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)
PY

Unterstü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.

Verwandte Modelle