Felo API PlatformFelo API Platform
חזרה למודלים

HY-World 2.1 Panorama API

מודל תמונה ייעודי של Tencent ליצירת פנורמה כדורית רציפה ברזולוציית4K מטקסט יחיד.

Tencent: HY-World2.1 Panorama הוא מודל יצירת תמונות ייעודי ממשפחת Hunyuan World, המקבל קלט טקסט ומפיק תמונת פנורמה אקו־רקטנגולרית אחת ברזולוציית4K. כל בקשה יוצרת פנורמה אחת, עם פריסת סצנה עקבית וחלקה לאורך הכדור המלא. אורך ההנחיה מוגבל ל־600 תווים.

המודל מתאים ליצירת סיורים וירטואליים, סקייבוקסים, בניית עולמות ואבות־טיפוס מהירים של סביבות משחק. הפנורמות יכולות לשמש בסיס לתכנון מסלולי מצלמה ולהרחבה סטריאוסקופית לסביבות תלת־ממד ניתנות לניווט, וכן ליצירת תוכן למציאות רבודה ולסימולציות אימון לרובוטיקה, כולל תכנון מסלול וניווט חזותי.

עדכון HY-World2.1 מביא גאומטריה נקייה יותר, רינדור חד יותר וטווח חקירה רחב יותר. נכסי תלת־ממד שנוצרו בתהליך הרחב יותר ניתנים לייבוא אל Unity, Unreal Engine ו־Blender. השירות זמין דרך OpenRouter מספק יחיד, Tencent Cloud, ובאמצעות API תואם OpenAI; ניתוב אזורי בתוך האיחוד האירופי אינו זמין כעת.

עודכן:

MODEL ID

hy-world-2.1-panorama
קלט
text
פלט
image

עיקרי הדברים

  • פנורמה כדורית יחידה
  • רזולוציית4K
  • פריסה חלקה סביב הכדור
  • הנחיות עד600 תווים
  • תמיכה ב־API תואם OpenAI
  • ייצוא לנכסי תלת־ממד

ספקים

1 ספקים

השוו מחירי API בין ספקים. בחרו ספק כדי לראות את כל החיובים והתנאים.

ספק · פירוט תמחור
זמינות

בנצ׳מרקים

  • Tanks-and-Temples

    ציון F1 של מערכת HY-World2.0 הקשורה

    41.43
  • MipNeRF360

    ציון של מערכת HY-World2.0 הקשורה

    51.27
  • שגיאת סיבוב

    מעלות עבור WorldStereo2.0, לעומת0.762 מעלות בגרסה1

    0.492
  • שגיאת תרגום

    מטרים עבור 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, המקבל קלט טקסט ומפיק תמונת פנורמה אקו־רקטנגולרית אחת ברזולוציית4K. כל בקשה יוצרת פנורמה אחת, עם פריסת סצנה עקבית וחלקה לאורך הכדור המלא. אורך ההנחיה מוגבל ל־600 תווים. המודל מתאים ליצירת סיורים וירטואליים, סקייבוקסים, בניית עולמות ואבות־טיפוס מהירים של סביבות משחק. הפנורמות יכולות לשמש בסיס לתכנון מסלולי מצלמה ולהרחבה סטריאוסקופית לסביבות תלת־ממד ניתנות לניווט, וכן ליצירת תוכן למציאות רבודה ולסימולציות אימון לרובוטיקה, כולל תכנון מסלול וניווט חזותי. עדכון HY-World2.1 מביא גאומטריה נקייה יותר, רינדור חד יותר וטווח חקירה רחב יותר. נכסי תלת־ממד שנוצרו בתהליך הרחב יותר ניתנים לייבוא אל Unity, Unreal Engine ו־Blender. השירות זמין דרך OpenRouter מספק יחיד, Tencent Cloud, ובאמצעות API תואם OpenAI; ניתוב אזורי בתוך האיחוד האירופי אינו זמין כעת.

איך מחייבים על השימוש?

החיוב שלכם תלוי בספק שאתם משתמשים בו, במחירים שלו ובשימוש שלכם. קלט ארוך יותר או תנאים אחרים עשויים להיות במחיר שונה. החיוב מבוסס על עלות היצירה בפועל. ראו את החשבונית לסכום הסופי.

אילו קלטים ופלטים המודל תומך?

המודל מקבל טקסט ומפיק תמונת פנורמה אקו־רקטנגולרית אחת ברזולוציית4K.

מה מגבלת ההנחיה והפלט?

ההנחיות מוגבלות ל־600 תווים. כל בקשה מפיקה פנורמה אחת.

לאילו משימות המודל מתאים?

הוא מתאים לסיורים וירטואליים, סקייבוקסים, בניית עולמות, יצירת נכסי סביבות משחק, מציאות רבודה וסימולציות רובוטיקה.

כיצד הוא משתלב בתהליך תלת־ממדי רחב יותר?

שלב יצירת הפנורמה הוא חלק מצינור ליצירת עולמות תלת־ממדיים ניתנים לחקירה, שיכול להפיק גם meshes, Gaussian splattings ו־point clouds.

מה ההבדל בינו לבין דגמים אחרים במשפחה?

HY-World2.1 Panorama מתמחה ביצירת פנורמות כדוריות מטקסט, בעוד ש־HY-World2.0, HY-Pano2.0 ו־Hy Image3.5 Preview הם דגמים אחרים באותה משפחת דגמים.

מודלים קשורים