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
Vergelijk API-prijzen tussen aanbieders. Kies een aanbieder om alle kosten en voorwaarden te bekijken.
| Beschikbaarheid | |
|---|---|
Historische gegevens zijn geen live statuscontrole. Ontbrekende gegevens betekenen geen storing.
Benchmarks
- 41.43
Tanks-and-Temples
F1-score voor het verwante HY-World2.0-systeem.
- 51.27
MipNeRF360
Score voor het verwante HY-World2.0-systeem.
- 0.492
Rotatiefout
Graden voor WorldStereo2.0, tegenover0.762 graden in versie1.
- 0.968
Translatiefout
Meter voor WorldStereo2.0, tegenover1.245 meter in versie1.
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")
PY4Uitvoer 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)
PYOndersteunde 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.