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

Hy Image 3.5 Preview API

Hy Image 3.5 Preview של Tencent הוא מודל גרסת תצוגה מקדימה ליצירת ועריכת תמונות, עם קלט טקסט ותמונות, עד 5 תמונות עזר בבקשה, רזולוציות 1K, 2K ו-4K ורינדור טקסט רב-לשוני.

Hy Image 3.5 Preview הוא מודל תמונות מבית Tencent, ששוחרר ב-22 בספטמבר 2026 בגרסת תצוגה מקדימה. הוא מקבל קלט טקסט וקלט תמונות ומייצר תמונות, ותומך ביצירה מטקסט, בעריכת תמונה מתוך תמונה ובעריכה שוטפת לאורך שיחה תוך הסתמכות על ההקשר הקודם. בבקשה אחת אפשר להעביר עד 5 תמונות עזר, והפלט זמין ברזולוציות 1K, 2K ו-4K ובמספר יחסי גובה-רוחב.

המודל מיועד ליצירה חזותית מקצועית: פרסומות, אינפוגרפיקות, עיצוב ממשקים, ריטוש תמונות, פורטרטים, כרטיסי מידע, פוסטרים מסחריים וסטוריבורדים לפרקים. הוא מצטיין ברינדור ריאליסטי של מרקם עור, אריגת בד ותאורת מתאר, ובהצגת טקסט וטיפוגרפיה במספר שפות, עם הבנה סמנטית חזקה של סינית. לפי Tencent, היכולת הכללית גבוהה בכ-30% מהדור הקודם בבדיקות הפנימיות של החברה.

המודל מוצג כמודל משתלם ליצירת תמונות מקצועית ולא כמוביל טבלאות דירוג. זמן הייצור החציוני עומד על כ-15.5 שניות, תמונת2K מרובעת אורכת כ-20 שניות ועריכה כ-23 שניות. ה-API משתמש בפרוטוקול Chat/Messages עם קלט מרובה תמונות, הקשר עריכה רב-תורי ושכתוב שרשרת מחשבה, ומזהה המודל הוא hy-image-v3.5-preview.

עודכן:

MODEL ID

hy-image-v3.5-preview
קלט
text / image
פלט
image

עיקרי הדברים

  • עד 5 תמונות עזר בבקשה
  • פלט ברזולוציות 1K, 2K ו-4K
  • רינדור טקסט רב-לשוני
  • עריכה עקבית לפי תמונות עזר
  • ריאליזם למסירה מסחרית
  • עריכה שוטפת בהקשר שיחה

ספקים

1 ספקים

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

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

התחלה מהירה

שלחו משימת תמונה, בדקו את מצבה ושמרו את התמונות. הדוגמאות משתמשות ב-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-image-v3.5-preview"
}'

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
input_references

לעריכת תמונה, החליפו את כתובת הדוגמה בכתובת HTTPS שלכם או ב-data URL של תמונת base64. שלחו פעם אחת והמשיכו באותם שלבי בדיקה ושמירה.

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": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "model": "hy-image-v3.5-preview",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

פרמטרים נתמכים

  • n
  • seed
  • size
  • resolution
  • aspect_ratio
  • input_references

מעדיפים את העיון המלא?

מסמכי API →

שאלות נפוצות

מהו Hy Image 3.5 Preview?

Hy Image 3.5 Preview הוא מודל תמונות מבית Tencent, ששוחרר ב-22 בספטמבר 2026 בגרסת תצוגה מקדימה. הוא מקבל קלט טקסט וקלט תמונות ומייצר תמונות, ותומך ביצירה מטקסט, בעריכת תמונה מתוך תמונה ובעריכה שוטפת לאורך שיחה תוך הסתמכות על ההקשר הקודם. בבקשה אחת אפשר להעביר עד 5 תמונות עזר, והפלט זמין ברזולוציות 1K, 2K ו-4K ובמספר יחסי גובה-רוחב. המודל מיועד ליצירה חזותית מקצועית: פרסומות, אינפוגרפיקות, עיצוב ממשקים, ריטוש תמונות, פורטרטים, כרטיסי מידע, פוסטרים מסחריים וסטוריבורדים לפרקים. הוא מצטיין ברינדור ריאליסטי של מרקם עור, אריגת בד ותאורת מתאר, ובהצגת טקסט וטיפוגרפיה במספר שפות, עם הבנה סמנטית חזקה של סינית. לפי Tencent, היכולת הכללית גבוהה בכ-30% מהדור הקודם בבדיקות הפנימיות של החברה. המודל מוצג כמודל משתלם ליצירת תמונות מקצועית ולא כמוביל טבלאות דירוג. זמן הייצור החציוני עומד על כ-15.5 שניות, תמונת2K מרובעת אורכת כ-20 שניות ועריכה כ-23 שניות. ה-API משתמש בפרוטוקול Chat/Messages עם קלט מרובה תמונות, הקשר עריכה רב-תורי ושכתוב שרשרת מחשבה, ומזהה המודל הוא hy-image-v3.5-preview.

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

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

אילו סוגי קלט המודל מקבל?

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

באילו רזולוציות ויחסי גובה-רוחב אפשר לקבל פלט?

הפלט זמין ברזולוציות1K, 2K ו-4K, במספר יחסי גובה-רוחב לבחירה.

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

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

במה שונה Hy Image 3.5 Preview מהדור הקודם?

לפי Tencent, היכולת הכללית שלו גבוהה בכ-30% מהדור הקודם בבדיקות פנימיות של החברה. מדובר בהערכת החברה, שדורשת אימות עצמאי.

האם זו גרסה יציבה?

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

כיצד ניגשים למודל?

מזהה המודל ב-API הוא hy-image-v3.5-preview, והפרוטוקול הוא Chat/Messages עם קלט מרובה תמונות והקשר עריכה רב-תורי. המודל זמין גם ב-Tencent Yuanbao וב-ima, ושולב בסביבת העבודה Tencent Cloud ADP.

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