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
المزوّدون
قارن أسعار API بين المزوّدين. اختر مزوّدًا لعرض جميع الرسوم والشروط.
| التوافر | |
|---|---|
الإحصاءات التاريخية ليست فحصًا مباشرًا للحالة. غياب البيانات لا يعني انقطاع الخدمة.
الاختبارات المرجعية
- 41.43
Tanks-and-Temples
درجة F1 لنظام HY-World2.0 المرتبط
- 51.27
MipNeRF360
النتيجة لنظام HY-World2.0 المرتبط
- 0.492
Rotation error
بالدرجات لـ WorldStereo2.0، مقارنةً بـ0.762 درجة في الإصدار1
- 0.968
Translation error
بالمتر لـ WorldStereo2.0، مقارنةً بـ1.245 متر في الإصدار1
الدرجات كما نشرها مزوّد النموذج.
البدء السريع
أرسل مهمة صورة، ثم استعلم عن حالتها واحفظ الصور. تستخدم الأمثلة 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")
PY4تنزيل الإخراج
بعد النجاح، احفظ 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، بينما لا تقدم المعلومات المتاحة مقارنة تفصيلية مباشرة مع النماذج الشقيقة.