Felo API PlatformFelo API Platform
Terug naar modellen

HY-World 2.1 Panorama API

Tencent HY-World2.1 Panorama maakt vanuit één tekstprompt één naadloze, hoogwaardige360-gradenpanoramaafbeelding.

HY-World2.1 Panorama is een gespecialiseerd beeldgeneratiemodel binnen de Hunyuan World-familie van Tencent. Het model ontvangt tekst en genereert per aanvraag één hoogwaardige360-graden-equirectangulaire panoramaafbeelding. De prompt mag maximaal600 tekens bevatten; de context is4K. Het model legt de nadruk op een coherente, naadloze scène-indeling over de volledige bol en levert scherpere rendering, schonere geometrie en een groter verkenbaar bereik dan de vorige update.

Het model is geschikt voor virtuele rondleidingen, skyboxes en het opbouwen van werelden. Panoramas kunnen dienen als basis voor camerabaanplanning en stereo-uitbreiding naar navigeerbare3D-omgevingen, maar ook voor snelle prototypes van game-assets, augmented-realitycontent en robotsimulaties voor routeplanning en visuele navigatie. Gegenereerde3D-assets kunnen worden geïmporteerd in Unity, Unreal Engine en Blender. HY-World2.1 Panorama is beschikbaar via een OpenAI-compatibele API, met Tencent Cloud als enige provider op OpenRouter.

Bijgewerkt:

MODEL-ID

hy-world-2.1-panorama
Invoer
text
Uitvoer
image

Hoogtepunten

  • Naadloze360°-scènes
  • 4K-context
  • Maximaal600 tekens
  • Unity-, Unreal- en Blender-import
  • Eén panorama per aanvraag

Aanbieders

1 aanbieders

Vergelijk API-prijzen tussen aanbieders. Kies een aanbieder om alle kosten en voorwaarden te bekijken.

Aanbieder · Prijsdetails
Beschikbaarheid

Benchmarks

  • Tanks-and-Temples

    F1-score voor het verwante HY-World2.0-systeem.

    41.43
  • MipNeRF360

    Score voor het verwante HY-World2.0-systeem.

    51.27
  • Rotatiefout

    Graden voor WorldStereo2.0, tegenover0.762 graden in versie1.

    0.492
  • Translatiefout

    Meter voor WorldStereo2.0, tegenover1.245 meter in versie1.

    0.968

Scores zoals gepubliceerd door de modelaanbieder.

Snelstart

Verstuur een afbeeldingstaak, controleer de status en sla de afbeeldingen op. De voorbeelden gebruiken curl en de standaardbibliotheek van Python 3.

POST https://openapi.felo.ai/api/v1/images/generations

1API-sleutel instellen

Maak een sleutel in je Felo API Platform-account en stel deze in als omgevingsvariabele.

export FELO_API_KEY="YOUR_API_KEY"

2Je eerste aanvraag doen

Optionele waarden verschillen per model en zijn hier niet ingesteld. Controleer ze in Playground. Velden staan naast model en prompt, zonder input-omslag.

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"
}'

3Taak pollen

De aanvraag retourneert task_id. Controleer elke 3 seconden bij queued of running; stop bij succeeded, failed of interrupted. Maximaal 30 minuten wachten. Bewaar created.json om dezelfde taak verder op te vragen zonder opnieuw te versturen.

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

4Uitvoer downloaden

Sla na succes outputs uit task.json op. HTTPS-URL’s, URL-objecten en b64_json worden ondersteund. Download ondertekende URL’s tijdig; daarvoor is geen API-sleutel nodig.

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

Ondersteunde parameters

  • n

Liever de volledige referentie?

API-referentie →

Veelgestelde vragen

Wat is HY-World 2.1 Panorama?

HY-World2.1 Panorama is een gespecialiseerd beeldgeneratiemodel binnen de Hunyuan World-familie van Tencent. Het model ontvangt tekst en genereert per aanvraag één hoogwaardige360-graden-equirectangulaire panoramaafbeelding. De prompt mag maximaal600 tekens bevatten; de context is4K. Het model legt de nadruk op een coherente, naadloze scène-indeling over de volledige bol en levert scherpere rendering, schonere geometrie en een groter verkenbaar bereik dan de vorige update. Het model is geschikt voor virtuele rondleidingen, skyboxes en het opbouwen van werelden. Panoramas kunnen dienen als basis voor camerabaanplanning en stereo-uitbreiding naar navigeerbare3D-omgevingen, maar ook voor snelle prototypes van game-assets, augmented-realitycontent en robotsimulaties voor routeplanning en visuele navigatie. Gegenereerde3D-assets kunnen worden geïmporteerd in Unity, Unreal Engine en Blender. HY-World2.1 Panorama is beschikbaar via een OpenAI-compatibele API, met Tencent Cloud als enige provider op OpenRouter.

Hoe wordt het gebruik gefactureerd?

Je factuur hangt af van de aanbieder die je gebruikt, de prijzen en je verbruik. Langere invoer of andere voorwaarden kunnen andere prijzen hebben. Gefactureerd op basis van de werkelijke generatiekosten. Zie je factuur voor het uiteindelijke bedrag.

Welke invoer en uitvoer ondersteunt het model?

Het model ondersteunt tekstinvoer en beelduitvoer. Elke aanvraag produceert één hoogwaardige360-graden-equirectangulaire panoramaafbeelding.

Hoe lang mag een prompt zijn en wat is de context?

Prompts zijn beperkt tot600 tekens. De context is4K.

Voor welke taken is HY-World2.1 Panorama geschikt?

Het is geschikt voor virtuele rondleidingen, skyboxes, wereldbouw, game-assets, augmented-realitycontent en robotsimulaties. Panoramas kunnen ook dienen als basis voor camerabaanplanning en navigeerbare3D-omgevingen.

Hoe verschilt dit model van de bredere Hunyuan World-pijplijn?

HY-World2.1 Panorama is de panoramageneratiefase binnen een grotere pijplijn voor verkenbare3D-werelden. Die bredere pijplijn kan meshes, Gaussian splattings en point clouds produceren.

Via welke interface is het model beschikbaar?

Het model is beschikbaar via een OpenAI-compatibele API en wordt op OpenRouter uitsluitend door Tencent Cloud aangeboden.

Gerelateerde modellen