Felo API PlatformFelo API Platform
العودة إلى النماذج

HY-World 2.1 Panorama API

نموذج متخصص من Tencent لإنشاء بانوراما كروية360 درجة عالية الدقة من مطالبة نصية واحدة.

يُعد Tencent: HY-World2.1 Panorama نموذجًا متخصصًا لتوليد الصور ضمن عائلة Hunyuan World. يستقبل نصًا فقط ويُنتج بانوراما واحدة عالية الدقة بصيغة إيكوساهيدراوية بزاوية360 درجة، مع تخطيط متماسك ومتصِل للمشهد عبر الكرة كاملة. تُحدَّد المطالبات بحد أقصى600 حرف، ويبلغ سياق النموذج4K.

يناسب النموذج الجولات الافتراضية، وصناديق السماء، وبناء العوالم، وإنشاء نماذج أولية سريعة لأصول بيئات الألعاب. ويمكن استخدام البانورامات كأساس لتخطيط مسارات الكاميرا وتوسيع المشاهد المجسمة إلى بيئات ثلاثية الأبعاد قابلة للاستكشاف، إضافة إلى محتوى الواقع المعزز ومحاكاة تدريب الروبوتات، بما في ذلك تخطيط المسارات والملاحة البصرية.

جاء تحديث HY-World2.1 بهندسة أنظف وتصيير أكثر حدة ونطاق استكشاف أوسع. ويمكن استيراد الأصول ثلاثية الأبعاد الناتجة إلى Unity وUnreal Engine وBlender. لا تتوفر درجات معيارية محددة لهذا النموذج نفسه، كما أنه غير متاح حاليًا عبر التوجيه داخل منطقة الاتحاد الأوروبي.

آخر تحديث:

MODEL ID

hy-world-2.1-panorama
الإدخال
text
الإخراج
image

أبرز الميزات

  • بانوراما كروية360 درجة
  • تخطيط مشهد متصل
  • إخراج واحد لكل طلب
  • مطالبات حتى600 حرف
  • دعم Unity وUnreal وBlender

المزوّدون

1 مزوّدون

قارن أسعار API بين المزوّدين. اختر مزوّدًا لعرض جميع الرسوم والشروط.

المزوّد · تفاصيل التسعير
التوافر

الاختبارات المرجعية

  • Tanks-and-Temples

    درجة F1 لنظام HY-World2.0 المرتبط

    41.43
  • MipNeRF360

    النتيجة لنظام HY-World2.0 المرتبط

    51.27
  • Rotation error

    بالدرجات لـ WorldStereo2.0، مقارنةً بـ0.762 درجة في الإصدار1

    0.492
  • Translation error

    بالمتر لـ WorldStereo2.0، مقارنةً بـ1.245 متر في الإصدار1

    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. استعلم كل 3 ثوانٍ أثناء queued أو running، وتوقف عند succeeded أو failed أو interrupted. الحد الأقصى للانتظار 30 دقيقة. احتفظ بملف 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. يستقبل نصًا فقط ويُنتج بانوراما واحدة عالية الدقة بصيغة إيكوساهيدراوية بزاوية360 درجة، مع تخطيط متماسك ومتصِل للمشهد عبر الكرة كاملة. تُحدَّد المطالبات بحد أقصى600 حرف، ويبلغ سياق النموذج4K. يناسب النموذج الجولات الافتراضية، وصناديق السماء، وبناء العوالم، وإنشاء نماذج أولية سريعة لأصول بيئات الألعاب. ويمكن استخدام البانورامات كأساس لتخطيط مسارات الكاميرا وتوسيع المشاهد المجسمة إلى بيئات ثلاثية الأبعاد قابلة للاستكشاف، إضافة إلى محتوى الواقع المعزز ومحاكاة تدريب الروبوتات، بما في ذلك تخطيط المسارات والملاحة البصرية. جاء تحديث HY-World2.1 بهندسة أنظف وتصيير أكثر حدة ونطاق استكشاف أوسع. ويمكن استيراد الأصول ثلاثية الأبعاد الناتجة إلى Unity وUnreal Engine وBlender. لا تتوفر درجات معيارية محددة لهذا النموذج نفسه، كما أنه غير متاح حاليًا عبر التوجيه داخل منطقة الاتحاد الأوروبي.

كيف تُحتسب فاتورة الاستخدام؟

تعتمد فاتورتك على المزوّد الذي تستخدمه وأسعاره واستخدامك. قد تختلف الأسعار مع المدخلات الأطول أو الشروط الأخرى. تُحتسب الفاتورة وفق تكلفة التوليد الفعلية. راجع فاتورتك للمبلغ النهائي.

ما أنواع المدخلات والمخرجات التي يدعمها؟

يدعم إدخال النص ويُنتج صورة بانورامية واحدة عالية الدقة بزاوية360 درجة.

ما حدود السياق وطول المطالبة؟

يبلغ السياق4K، وتقتصر المطالبة على600 حرف.

ما المهام المناسبة له؟

يناسب الجولات الافتراضية، وبناء العوالم، وأصول بيئات الألعاب، والواقع المعزز، ومحاكاة الروبوتات.

ما الفرق بينه وبين النماذج الشقيقة؟

هو نموذج بانورامي متخصص داخل عائلة Hunyuan World، بينما لا تقدم المعلومات المتاحة مقارنة تفصيلية مباشرة مع النماذج الشقيقة.

نماذج ذات صلة