Felo API PlatformFelo API Platform
Retour aux modèles

HY-World 2.1 Panorama API

Modèle spécialisé de Tencent générant une panorama équirectangulaire360 degrés haute résolution à partir d’un seul prompt textuel.

HY-World2.1 Panorama est un modèle de génération d’images spécialisé de la famille Hunyuan World de Tencent. À partir d’un prompt textuel unique, il produit une panorama équirectangulaire360 degrés haute résolution, avec une disposition cohérente et continue sur toute la sphère. Chaque requête génère une seule panorama, et les prompts sont limités à600 caractères. Le contexte indiqué est4K, avec une entrée texte et une sortie image.

Il convient aux visites virtuelles, aux skyboxes, à la création de mondes et au prototypage rapide d’environnements de jeu. Les panoramas peuvent aussi servir de base à la planification de trajectoires de caméra et à l’extension stéréo vers des environnements3D navigables, ainsi qu’à la création de contenus de réalité augmentée et à la simulation pour l’entraînement robotique. Les actifs3D générés peuvent être importés dans Unity, Unreal Engine et Blender. Le modèle est proposé sur OpenRouter par Tencent Cloud comme fournisseur unique et accessible via une API compatible avec OpenAI. Aucun score spécifique à HY-World2.1 Panorama n’est fourni.

Mis à jour:

ID DU MODÈLE

hy-world-2.1-panorama
Entrée
text
Sortie
image

Points clés

  • Panoramas360 degrés
  • Sortie haute résolution
  • Disposition sphérique cohérente
  • Prompt limité à600 caractères
  • Compatible Unity, Unreal et Blender
  • API compatible OpenAI

Fournisseurs

1 fournisseurs

Comparez les prix des API entre fournisseurs. Sélectionnez un fournisseur pour voir tous les tarifs et conditions.

Fournisseur · Détails des tarifs
Disponibilité

Benchmarks

  • Tanks-and-Temples

    Score F1 du système HY-World2.0 associé.

    41.43
  • MipNeRF360

    Score du système HY-World2.0 associé.

    51.27
  • Rotation error

    Erreur en degrés pour WorldStereo2.0, contre0.762 degrés pour la version1.

    0.492
  • Translation error

    Erreur en mètres pour WorldStereo2.0, contre1.245 mètres pour la version1.

    0.968

Scores tels que publiés par le fournisseur du modèle.

Démarrage rapide

Envoyez une tâche image, consultez son état, puis enregistrez les images. Les exemples utilisent curl et la bibliothèque standard de Python 3.

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

1Configurer votre clé API

Créez une clé depuis votre compte Felo API Platform et définissez-la comme variable d'environnement.

export FELO_API_KEY="YOUR_API_KEY"

2Effectuer votre première requête

Les valeurs facultatives dépendent du modèle et ne sont pas prédéfinies ici. Vérifiez-les dans Playground. Les champs sont au même niveau que model et prompt, sans enveloppe input.

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

3Interroger la tâche

La soumission renvoie task_id. Interrogez toutes les 3 secondes pendant queued ou running ; arrêtez à succeeded, failed ou interrupted. Attente maximale : 30 minutes. Gardez created.json pour reprendre sans soumettre une nouvelle tâche.

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

4Télécharger la sortie

Après réussite, enregistrez outputs depuis task.json : URL HTTPS, objets URL ou b64_json. Téléchargez rapidement les URL signées. Le téléchargement des images ne nécessite pas de clé API.

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

Paramètres pris en charge

  • n

Besoin de la référence complète ?

Référence API →

Questions fréquentes

Qu'est-ce que HY-World 2.1 Panorama?

HY-World2.1 Panorama est un modèle de génération d’images spécialisé de la famille Hunyuan World de Tencent. À partir d’un prompt textuel unique, il produit une panorama équirectangulaire360 degrés haute résolution, avec une disposition cohérente et continue sur toute la sphère. Chaque requête génère une seule panorama, et les prompts sont limités à600 caractères. Le contexte indiqué est4K, avec une entrée texte et une sortie image. Il convient aux visites virtuelles, aux skyboxes, à la création de mondes et au prototypage rapide d’environnements de jeu. Les panoramas peuvent aussi servir de base à la planification de trajectoires de caméra et à l’extension stéréo vers des environnements3D navigables, ainsi qu’à la création de contenus de réalité augmentée et à la simulation pour l’entraînement robotique. Les actifs3D générés peuvent être importés dans Unity, Unreal Engine et Blender. Le modèle est proposé sur OpenRouter par Tencent Cloud comme fournisseur unique et accessible via une API compatible avec OpenAI. Aucun score spécifique à HY-World2.1 Panorama n’est fourni.

Comment l'usage est-il facturé ?

Votre facture dépend du fournisseur utilisé, de ses tarifs et de votre usage. Des entrées plus longues ou d'autres conditions peuvent avoir des tarifs différents. Facturé selon le coût réel de génération. Consultez votre facture pour le montant final.

Quels types d’entrées et de sorties sont pris en charge ?

Le modèle accepte une entrée texte et produit une image panoramique équirectangulaire360 degrés. Chaque requête génère une seule panorama.

Quelle est la limite des prompts ?

Les prompts sont limités à600 caractères. Le contexte indiqué est4K.

Pour quelles tâches ce modèle est-il adapté ?

Il convient aux visites virtuelles, aux skyboxes, au world-building, au prototypage d’environnements de jeu, à la réalité augmentée et à la simulation robotique.

Les actifs générés peuvent-ils être utilisés dans des outils3D ?

Les actifs3D générés peuvent être importés dans Unity, Unreal Engine et Blender.

Comment se compare-t-il aux autres modèles de la même famille ?

HY-World2.1 Panorama est spécialisé dans la génération de panoramas360 degrés. Les informations fournies ne détaillent pas les différences avec HY-World2.0, HY-Pano2.0 ou Hy Image3.5 Preview.

Modèles liés