Felo API PlatformFelo API Platform
Kembali ke model

HY-World 2.1 Panorama API

HY-World2.1 Panorama menghasilkan satu panorama equirektangular360 derajat beresolusi tinggi dari satu perintah teks.

HY-World2.1 Panorama adalah model generasi gambar khusus dari keluarga Hunyuan World milik Tencent. Model ini menerima input teks dan menghasilkan satu panorama equirektangular360 derajat beresolusi tinggi untuk setiap permintaan. Tata letak adegan dirancang agar koheren dan mulus di seluruh bola panorama, dengan batas prompt600 karakter serta konteks4K.

Model ini cocok untuk tur virtual, skybox, pembangunan dunia, dan pembuatan prototipe cepat aset lingkungan gim. Panorama yang dihasilkan juga dapat menjadi dasar perencanaan jalur kamera serta perluasan stereo menuju lingkungan3D yang dapat dinavigasi, termasuk simulasi pelatihan robotika, perencanaan jalur, dan navigasi visual. Aset3D yang dihasilkan dapat diimpor ke Unity, Unreal Engine, dan Blender.

Pembaruan HY-World2.1 menghadirkan geometri yang lebih bersih, rendering lebih tajam, dan jangkauan eksplorasi yang lebih luas. Model ini tersedia melalui OpenRouter dari Tencent Cloud sebagai satu-satunya penyedia, melalui API yang kompatibel dengan OpenAI. Tidak ada skor tolok ukur khusus untuk HY-World2.1 Panorama yang disediakan.

Diperbarui:

ID MODEL

hy-world-2.1-panorama
Masukan
text
Keluaran
image

Sorotan

  • Panorama360 derajat
  • Output equirektangular
  • Tata letak adegan mulus
  • Konteks4K
  • Kompatibel dengan OpenAI API

Penyedia

1 penyedia

Bandingkan harga API antarpenyedia. Pilih penyedia untuk melihat semua biaya dan ketentuan.

Penyedia · Detail harga
Ketersediaan

Tolok ukur

  • Tanks-and-Temples

    Skor F1 untuk sistem HY-World2.0 terkait.

    41.43
  • MipNeRF360

    Skor untuk sistem HY-World2.0 terkait.

    51.27
  • Rotation error

    Derajat untuk WorldStereo2.0, dibandingkan dengan0.762 derajat pada versi1.

    0.492
  • Translation error

    Meter untuk WorldStereo2.0, dibandingkan dengan1.245 meter pada versi1.

    0.968

Skor sesuai publikasi penyedia model.

Mulai cepat

Kirim tugas gambar, periksa status, lalu simpan gambar. Contoh menggunakan curl dan pustaka standar Python 3.

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

1Siapkan kunci API

Buat kunci dari akun Felo API Platform Anda dan tetapkan sebagai variabel lingkungan.

export FELO_API_KEY="YOUR_API_KEY"

2Kirim permintaan pertama

Nilai opsional berbeda per model dan tidak ditetapkan di sini. Periksa di Playground. Kolom sejajar dengan model dan prompt, tanpa pembungkus 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"
}'

3Polling tugas

Pengiriman mengembalikan task_id. Periksa setiap 3 detik saat queued atau running; berhenti saat succeeded, failed, atau interrupted. Tunggu maksimal 30 menit. Simpan created.json untuk melanjutkan pemeriksaan tanpa mengirim ulang.

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

4Unduh output

Setelah berhasil, simpan outputs dari task.json. Mendukung URL HTTPS, objek URL, dan b64_json. Segera unduh URL bertanda tangan; unduhan gambar tidak memerlukan kunci 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

Parameter yang didukung

  • n

Ingin referensi lengkap?

Referensi API →

Pertanyaan umum

Mengenal HY-World 2.1 Panorama?

HY-World2.1 Panorama adalah model generasi gambar khusus dari keluarga Hunyuan World milik Tencent. Model ini menerima input teks dan menghasilkan satu panorama equirektangular360 derajat beresolusi tinggi untuk setiap permintaan. Tata letak adegan dirancang agar koheren dan mulus di seluruh bola panorama, dengan batas prompt600 karakter serta konteks4K. Model ini cocok untuk tur virtual, skybox, pembangunan dunia, dan pembuatan prototipe cepat aset lingkungan gim. Panorama yang dihasilkan juga dapat menjadi dasar perencanaan jalur kamera serta perluasan stereo menuju lingkungan3D yang dapat dinavigasi, termasuk simulasi pelatihan robotika, perencanaan jalur, dan navigasi visual. Aset3D yang dihasilkan dapat diimpor ke Unity, Unreal Engine, dan Blender. Pembaruan HY-World2.1 menghadirkan geometri yang lebih bersih, rendering lebih tajam, dan jangkauan eksplorasi yang lebih luas. Model ini tersedia melalui OpenRouter dari Tencent Cloud sebagai satu-satunya penyedia, melalui API yang kompatibel dengan OpenAI. Tidak ada skor tolok ukur khusus untuk HY-World2.1 Panorama yang disediakan.

Bagaimana penggunaan ditagih?

Tagihan Anda bergantung pada penyedia yang digunakan, tarifnya, dan penggunaan Anda. Masukan yang lebih panjang atau ketentuan lain dapat memiliki harga berbeda. Ditagih berdasarkan biaya pembuatan sebenarnya. Lihat tagihan Anda untuk jumlah akhir.

Input dan output apa yang didukung?

Model ini mendukung input teks dan menghasilkan gambar panorama. Setiap permintaan menghasilkan satu panorama equirektangular360 derajat.

Berapa batas prompt dan konteksnya?

Prompt dibatasi hingga600 karakter, dengan konteks4K.

Untuk tugas apa model ini cocok?

Model ini cocok untuk tur virtual, skybox, pembangunan dunia, prototipe aset lingkungan gim, augmented reality, serta simulasi robotika.

Apa perbedaan pembaruan HY-World2.1?

Pembaruan ini membawa geometri yang lebih bersih, rendering lebih tajam, dan jangkauan eksplorasi yang lebih luas dibandingkan versi sebelumnya.

Model terkait