Felo API PlatformFelo API Platform
Volver a los modelos

HY-World 2.1 Panorama API

Genera una panorámica equirectangular de360 grados a partir de texto, con escenas coherentes y continuas para entornos3D explorables.

Tencent: HY-World2.1 Panorama es un modelo especializado de generación de imágenes dentro de la familia Hunyuan World. A partir de una sola instrucción de texto, genera una panorámica equirectangular de alta resolución y360 grados, con una distribución de escena coherente y sin interrupciones en toda la esfera. Cada solicitud produce una panorámica, y las instrucciones admiten hasta600 caracteres.

Está pensado para crear recorridos virtuales, skyboxes, prototipos rápidos de entornos para videojuegos y contenido de realidad aumentada. También puede servir como base para planificar trayectorias de cámara y ampliar escenas estéreo hacia entornos3D navegables, así como para simulaciones de entrenamiento robótico con planificación de rutas y navegación visual. Los activos3D generados pueden importarse en Unity, Unreal Engine y Blender.

Se ofrece en OpenRouter mediante Tencent Cloud como proveedor exclusivo y dispone de una API compatible con OpenAI. Su actualización aporta geometría más limpia, renderizado más nítido y un rango explorable mayor. No se proporcionan puntuaciones de referencia específicas para HY-World2.1 Panorama, y actualmente no está disponible mediante enrutamiento regional dentro de la UE.

Actualizado:

ID DEL MODELO

hy-world-2.1-panorama
Entrada
text
Salida
image

Aspectos destacados

  • Panorámicas de360 grados
  • Escena esférica coherente
  • Instrucciones de600 caracteres
  • Compatible con Unity
  • Compatible con Unreal Engine
  • Compatible con Blender

Proveedores

1 proveedores

Compara los precios de API entre proveedores. Selecciona un proveedor para ver todos los cargos y condiciones.

Proveedor · Detalles de precio
Disponibilidad

Benchmarks

  • Tanks-and-Temples

    Puntuación F1 del sistema relacionado HY-World2.0.

    41.43
  • MipNeRF360

    Puntuación del sistema relacionado HY-World2.0.

    51.27
  • Rotation error

    Grados para WorldStereo2.0, frente a0.762 grados en la versión1.

    0.492
  • Translation error

    Metros para WorldStereo2.0, frente a1.245 metros en la versión1.

    0.968

Puntuaciones según lo publicado por el proveedor del modelo.

Inicio rápido

Envía una tarea de imagen, consulta su estado y guarda las imágenes. Los ejemplos usan curl y la biblioteca estándar de Python 3.

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

1Configura tu clave de API

Crea una clave en tu cuenta de Felo API Platform y configúrala como variable de entorno.

export FELO_API_KEY="YOUR_API_KEY"

2Haz tu primera solicitud

Los valores opcionales dependen del modelo y se omiten en el ejemplo. Confírmalos en Playground. Los campos van al mismo nivel que model y prompt, sin envoltorio 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"
}'

3Consultar tarea

La respuesta incluye task_id. Consulta cada 3 segundos mientras esté queued o running; termina con succeeded, failed o interrupted. Espera máxima: 30 minutos. Conserva created.json para continuar sin volver a enviar la tarea.

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

4Descargar salida

Tras el éxito, guarda outputs de task.json. Admite URL HTTPS, objetos URL y b64_json. Descarga pronto las URL firmadas; no necesitas la clave API para descargar imágenes.

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

Parámetros compatibles

  • n

¿Prefieres la referencia completa?

Referencia de la API →

Preguntas frecuentes

¿Qué es HY-World 2.1 Panorama?

Tencent: HY-World2.1 Panorama es un modelo especializado de generación de imágenes dentro de la familia Hunyuan World. A partir de una sola instrucción de texto, genera una panorámica equirectangular de alta resolución y360 grados, con una distribución de escena coherente y sin interrupciones en toda la esfera. Cada solicitud produce una panorámica, y las instrucciones admiten hasta600 caracteres. Está pensado para crear recorridos virtuales, skyboxes, prototipos rápidos de entornos para videojuegos y contenido de realidad aumentada. También puede servir como base para planificar trayectorias de cámara y ampliar escenas estéreo hacia entornos3D navegables, así como para simulaciones de entrenamiento robótico con planificación de rutas y navegación visual. Los activos3D generados pueden importarse en Unity, Unreal Engine y Blender. Se ofrece en OpenRouter mediante Tencent Cloud como proveedor exclusivo y dispone de una API compatible con OpenAI. Su actualización aporta geometría más limpia, renderizado más nítido y un rango explorable mayor. No se proporcionan puntuaciones de referencia específicas para HY-World2.1 Panorama, y actualmente no está disponible mediante enrutamiento regional dentro de la UE.

¿Cómo se cobra el uso?

Tu factura depende del proveedor que uses, de sus precios y de tu uso. Las entradas más largas u otras condiciones pueden tener precios distintos. Se factura según el costo real de generación. Consulta tu factura para el importe final.

¿Qué entradas y salidas admite?

Acepta texto como entrada y genera una imagen panorámica equirectangular de360 grados. Cada solicitud produce una panorámica.

¿Cuál es el límite de las instrucciones?

Las instrucciones están limitadas a600 caracteres. El contexto indicado es4K.

¿Para qué tareas resulta adecuado?

Es adecuado para recorridos virtuales, skyboxes, creación de entornos de videojuegos, realidad aumentada y simulaciones robóticas.

¿Cómo se diferencia de otros modelos de la familia?

HY-World2.1 Panorama se centra en generar panorámicas completas para construir mundos3D explorables. La información disponible no detalla aquí las funciones específicas de cada modelo hermano.

¿Dónde se ofrece?

Está disponible en OpenRouter mediante Tencent Cloud como proveedor exclusivo y ofrece una API compatible con OpenAI.

Modelos relacionados