Felo API PlatformFelo API Platform
بازگشت به مدل‌ها

HY-World 2.1 Panorama API

مدلی تخصصی برای ساخت یک پانورامای equirectangular سه‌صدوشصت‌درجه‌ای با وضوح4K از یک پرامپت متنی واحد است.

Tencent: HY-World2.1 Panorama یک مدل تولید تصویر تخصصی در خانواده Hunyuan World است که از یک پرامپت متنی، یک پانورامای equirectangular سه‌صدوشصت‌درجه‌ای با وضوح4K تولید می‌کند. هر درخواست یک پانوراما می‌سازد و پرامپت‌ها حداکثر600 کاراکتر هستند. این مدل چیدمان صحنه‌ای منسجم و بدون درز را در سراسر کره تصویر هدف می‌گیرد و از طریق OpenRouter، با ارائه‌دهندگی Tencent Cloud، در قالب API سازگار با OpenAI عرضه می‌شود.

این مدل برای تورهای مجازی، skybox، ساخت جهان، نمونه‌سازی سریع دارایی‌های محیطی بازی و تولید محتوای واقعیت افزوده مناسب است. پانوراماهای تولیدشده می‌توانند به‌عنوان پایه‌ای برای برنامه‌ریزی مسیر دوربین و گسترش استریو به محیط‌های سه‌بعدی قابل پیمایش استفاده شوند. دارایی‌های سه‌بعدی تولیدشده در جریان گسترده‌تر این سامانه با Unity، Unreal Engine و Blender قابل واردکردن هستند و کاربردهایی مانند شبیه‌سازی آموزش رباتیک، برنامه‌ریزی مسیر و ناوبری بصری دارند.

به‌روزرسانی HY-World2.1 هندسه تمیزتر، رندر واضح‌تر و دامنه قابل کاوش بزرگ‌تری ارائه می‌کند. امتیازهای ارائه‌شده در فهرست معیارها مربوط به سامانه‌های مرتبط HY-World2.0 و WorldStereo2.0 هستند، نه خود HY-World2.1 Panorama؛ همچنین این مدل در حال حاضر از مسیریابی درون‌منطقه‌ای اتحادیه اروپا پشتیبانی نمی‌کند.

به‌روزرسانی:

MODEL ID

hy-world-2.1-panorama
ورودی
text
خروجی
image

نکات برجسته

  • پانورامای4K
  • خروجی سه‌صدوشصت‌درجه‌ای
  • چیدمان بدون درز صحنه
  • پشتیبانی از API سازگار با OpenAI
  • قابل استفاده در Unity و Blender

ارائه‌دهندگان

1 ارائه‌دهنده

قیمت API را بین ارائه‌دهندگان مقایسه کنید. یک ارائه‌دهنده را انتخاب کنید تا همه هزینه‌ها و شرایط را ببینید.

ارائه‌دهنده · جزئیات قیمت‌گذاری
دسترس‌پذیری

بنچمارک‌ها

  • Tanks-and-Temples

    امتیاز F1 برای سامانه مرتبط HY-World2.0 است، نه خود این مدل.

    41.43
  • MipNeRF360

    این امتیاز به سامانه مرتبط HY-World2.0 مربوط است، نه خود این مدل.

    51.27
  • Rotation error

    خطای چرخش بر حسب درجه برای WorldStereo2.0؛ در نسخه1 مقدار0.762 درجه گزارش شده است.

    0.492
  • Translation error

    خطای انتقال بر حسب متر برای WorldStereo2.0؛ در نسخه1 مقدار1.245 متر گزارش شده است.

    0.968

امتیازها همان‌گونه که ارائه‌دهنده مدل منتشر کرده است.

شروع سریع

وظیفه تصویر را ارسال کنید، وضعیت را بررسی و تصاویر را ذخیره کنید. مثال‌ها از curl و کتابخانه استاندارد Python 3 استفاده می‌کنند.

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

1کلید API خود را بگیرید

از حساب Felo API Platform خود کلیدی بسازید و آن را به‌عنوان متغیر محیطی تنظیم کنید.

export FELO_API_KEY="YOUR_API_KEY"

2اولین درخواست خود را بفرستید

مقادیر اختیاری به مدل بستگی دارند و اینجا تنظیم نشده‌اند. آن‌ها را در Playground تأیید کنید. فیلدها هم‌سطح model و prompt هستند و داخل 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"
}'

3بررسی وظیفه

ارسال، task_id برمی‌گرداند. در queued یا running هر ۳ ثانیه بررسی کنید؛ در succeeded، failed یا interrupted متوقف شوید. حداکثر انتظار ۳۰ دقیقه است. برای ادامه بررسی بدون ارسال مجدد، created.json را نگه دارید.

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

4دانلود خروجی

پس از موفقیت، outputs را از task.json ذخیره کنید. نشانی HTTPS، شیء URL و b64_json پشتیبانی می‌شوند. پیوندهای امضاشده را زود دانلود کنید؛ دانلود تصویر به کلید 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

پارامترهای پشتیبانی‌شده

  • n

مرجع کامل را ترجیح می‌دهید؟

مرجع API →

پرسش‌های متداول

معرفی مدل: HY-World 2.1 Panorama?

Tencent: HY-World2.1 Panorama یک مدل تولید تصویر تخصصی در خانواده Hunyuan World است که از یک پرامپت متنی، یک پانورامای equirectangular سه‌صدوشصت‌درجه‌ای با وضوح4K تولید می‌کند. هر درخواست یک پانوراما می‌سازد و پرامپت‌ها حداکثر600 کاراکتر هستند. این مدل چیدمان صحنه‌ای منسجم و بدون درز را در سراسر کره تصویر هدف می‌گیرد و از طریق OpenRouter، با ارائه‌دهندگی Tencent Cloud، در قالب API سازگار با OpenAI عرضه می‌شود. این مدل برای تورهای مجازی، skybox، ساخت جهان، نمونه‌سازی سریع دارایی‌های محیطی بازی و تولید محتوای واقعیت افزوده مناسب است. پانوراماهای تولیدشده می‌توانند به‌عنوان پایه‌ای برای برنامه‌ریزی مسیر دوربین و گسترش استریو به محیط‌های سه‌بعدی قابل پیمایش استفاده شوند. دارایی‌های سه‌بعدی تولیدشده در جریان گسترده‌تر این سامانه با Unity، Unreal Engine و Blender قابل واردکردن هستند و کاربردهایی مانند شبیه‌سازی آموزش رباتیک، برنامه‌ریزی مسیر و ناوبری بصری دارند. به‌روزرسانی HY-World2.1 هندسه تمیزتر، رندر واضح‌تر و دامنه قابل کاوش بزرگ‌تری ارائه می‌کند. امتیازهای ارائه‌شده در فهرست معیارها مربوط به سامانه‌های مرتبط HY-World2.0 و WorldStereo2.0 هستند، نه خود HY-World2.1 Panorama؛ همچنین این مدل در حال حاضر از مسیریابی درون‌منطقه‌ای اتحادیه اروپا پشتیبانی نمی‌کند.

هزینه استفاده چگونه محاسبه می‌شود؟

صورت‌حساب شما به ارائه‌دهنده‌ای که استفاده می‌کنید، قیمت‌های آن و میزان مصرف شما بستگی دارد. ورودی‌های طولانی‌تر یا شرایط دیگر ممکن است قیمت متفاوتی داشته باشند. صورت‌حساب بر اساس هزینه واقعی تولید محاسبه می‌شود. مبلغ نهایی را در صورت‌حساب ببینید.

چه ورودی و خروجی‌ای پشتیبانی می‌شود؟

ورودی مدل متن و خروجی آن تصویر است. هر درخواست یک پانورامای equirectangular سه‌صدوشصت‌درجه‌ای تولید می‌کند.

محدودیت پرامپت و وضوح چیست؟

پرامپت‌ها حداکثر600 کاراکتر هستند و زمینه مدل4K است.

این مدل برای چه کارهایی مناسب است؟

برای تورهای مجازی، skybox، ساخت جهان، دارایی‌های محیطی بازی، واقعیت افزوده و شبیه‌سازی آموزش رباتیک مناسب است.

چه تفاوتی با مدل‌های هم‌خانواده دارد؟

این مدل بر تولید پانورامای سه‌صدوشصت‌درجه‌ای تمرکز دارد و بخشی از جریان بزرگ‌تر ساخت جهان‌های سه‌بعدی قابل کاوش است.

مدل‌های مرتبط