Tencent: Hy Image 3.5 Preview

HY Image 3.5 Preview משלב יצירת תמונות מטקסט, יצירה מבוססת ייחוס ועריכה מרובת סבבים. Tencent מתעדת תמיכה בעד 20 תמונות ייחוס, בחירת גודל אוטומטית וגדלי פלט מפורשים עד תמונה בגודל 4096 × 4096 לעבודות חזותיות מפורטות.

Ailoot Ultra · תמונות POST /v1/images/generations tencent/hy-image-v3.5-preview

על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.

HY Image 3.5 Preview הוא המודל המאוחד של Tencent ליצירת תמונות ולעריכתן. הוא מקבל תדריך כתוב עם תמונות ייחוס אופציונליות ותומך בהמשך אותה משימה חזותית לאורך כמה סבבים. התוצאה היא תמונה לסצנה, לקומפוזיציה או לעריכה מוגדרות. דוגמאות Tencent כוללות תמונות מוצר, כרזות קמפיין, הדמיות עיצוב ממשקים ורעיונות לחומרים. בחרו אם המשימה דורשת תמונה חדשה, קומפוזיציה המסתמכת על ייחוס או שינוי ממוקד של תוצאה קיימת.

היצרן מזהה את המהדורה כ־hy-image-v3.5-preview ומתעד מגבלת הנחיה של 100K טוקנים. הקלט הוא שיחה כרונולוגית הכוללת טקסט ותמונות, כאשר הודעת המשתמש האחרונה מספקת את ההוראה הנוכחית. הודעות קודמות נותנות הקשר לעריכה איטרטיבית. זה שונה מתהליך ההנחיה היחידה של HY Image 3.0 וממגבלות הקלט הנפרדות שלו. במשימת עיצוב מתמשכת, שימרו את התדריך הרלוונטי, תפקידי תמונות הייחוס והתמונה שנבחרה כדי שההוראה הבאה תיבנה על המצב החזותי המיועד.

הכינו תמונות ייחוס בפורמט PNG או JPEG/JPG. בתהליך המתועד, קלטי הייחוס יכולים לכלול עד 20 תמונות, שכל אחת מהן בגודל של עד 20 MB. אפשר לספק תמונה באמצעות הפניה לנכס או כנכס מקודד. אם השיחה מכילה יותר מדי תמונות, מדריך היצרן מתאר הסרה של התמונות הישנות תחילה. שימרו קבוצת ייחוס פעילה וממוקדת במקום להסתמך על כך שכל תמונה היסטורית תישאר בהקשר. בקרת שינוי גודל הקלט משמרת תמונות קטנות ומקטינה תמונות גדולות באופן יחסי לעבר יעד שטח פיקסלים; יעד ברירת המחדל הוא 1,048,576 פיקסלים. שימרו מספיק פרטים נראים של המוצר, החומר או הפריסה שצריכים להנחות את התוצאה.

לגודל הפלט יש שני מסלולי הכנה נפרדים. בגודל אוטומטי, generate_max_pixels מגדיר שטח יעד: 1,048,576 פיקסלים לרמת 1K, ‏2,359,296 לרמת 1.5K המוגדרת כברירת מחדל, או 4,194,304 ל־2K. בשאלות הנפוצות של היצרן נאמר שהגדרת שטח יעד הניתנת לבדה משתמשת כברירת מחדל ביחס ריבועי. כאשר שתי בקרות הגודל מושמטות, המודל משתמש בתדריך וברמת 1.5K המוגדרת כברירת מחדל. הרמות האלה אינן יוצרות הגדרת 4K אוטומטית. השתמשו ברמת שטח כאשר תמונה ריבועית מתאימה למשימה. כדי שהתדריך ינחה את הפרופורציות ברמת 1.5K הרגילה, השמיטו את שתי בקרות הגודל; בקשו מידות מפורשות כשהפריסה דורשת גודל אנכי או רחב מסוים.

למידות מפורשות, היצרן מתיר אורכי צלע של מספרים שלמים חיוביים מ־256 עד 8192 פיקסלים, עם שטח כולל שלא יעלה על 16,777,216 פיקסלים. ריבוע של 4096 × 4096 עומד במגבלה. טווח הצלעות ותקרת השטח חלים יחד, ולכן צלע של 8192 פיקסלים אינה מתירה תמונה בגודל 8192 × 8192. בקשו רוחב וגובה מפורשים כאשר הפריסה הסופית דורשת גודל מסוים, במקום להניח שרמת שטח יעד קובעת את אותן מידות. ציינו בהנחיה פרטים הרגישים לחיתוך ואת החלל הריק הנדרש.

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

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

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

Ailoot Ultra · תמונות POST /v1/images/generations tencent/hy-image-v3.5-preview

tencent/hy-image-v3.5-preview

Tencent /tencent/hy-image-v3.5-preview

התחלה

סוגי קלט נתמכים: טקסט · תמונות
תוצאות: תמונות

זמין ב-Ailoot · קלט ושיטות

Ailoot Ultra · תמונות POST /v1/images/generations

סוגי קלט: text, image
סוגי פלט: image

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות tencent/hy-image-v3.5-preview	ברירת מחדל—
שדה`prompt`	סוג`string`	דרישהחובה	ערכים ומגבלות אורך מזערי: ⁦1⁩	ברירת מחדל—
שדה`resolution`	סוג`string`	דרישהרשות	ערכים ומגבלות 1K, 1.5K, 2K, 4K	ברירת מחדל—
שדה`aspect_ratio`	סוג`string`	דרישהרשות	ערכים ומגבלות 1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9	ברירת מחדל—
שדה`n`	סוג`integer`	דרישהרשות	ערכים ומגבלות מינימום: ⁦1⁩ מקסימום: ⁦1⁩	ברירת מחדל—
שדה`input_references`	סוג`array`	דרישהרשות	ערכים ומגבלות מספר פריטים מזערי: ⁦0⁩ מספר פריטים מרבי: ⁦20⁩	ברירת מחדל—
שדה`provider`	סוג`object`	דרישהרשות	ערכים ומגבלות	ברירת מחדל—

פרמטרים ומחזור חיים של השיטה

פרמטר	מפרט
פרמטר`content_type`	מפרטapplication/json
פרמטר`required`	מפרטmodel, prompt
פרמטר`material_types`	מפרטtext, image

מחזור חיים: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · ערך task_id שהוחזר בפועל או רשומה בספריית המדיה

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

תעריפים

אופן חישוב החיוב הסופי

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

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

מצב מהיר: לא צוין כאשר נבחר מצב מהיר
מצב Flex: לא צוין כאשר נבחר מצב flex
מאמץ חשיבה מרבי: לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)

תעריפים משוערים להשוואה

מחירים לפי תצורה

התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.

תצורה	טבלת תעריפים	כמות חזויה	יחידת חיוב	חיוב
תצורהתעריפי בסיס לטוקנים	טבלת תעריפיםתעריף בסיס	כמות חזויה—	יחידת חיוב—	חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים
תצורהטוקן תמונה בפלט	טבלת תעריפים—	כמות חזויה—	יחידת חיוב/ 1K טוקני תמונה	חיוב פלט · טוקן תמונה בפלט · אומדן להשוואה בלבד $0.0032 / 1K טוקני תמונה
תצורהעלות יצירה משוערת	טבלת תעריפים—	כמות חזויהאומדן ליצירה אחת	יחידת חיוב—	חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.0131072 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

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

דוגמאות לבקשות

Ailoot Ultra · תמונות

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'tencent/hy-image-v3.5-preview', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

קבלה ושמירה של תוצאות

Ailoot Ultra · תמונות

הורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

קריאות תוכן נוספות

קריאת נכסים קיימים שבבעלותכם

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

שמירת כל התוצאות שהושלמו

שמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-Base64 שלה.

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

כשצריך לבדוק את התגובה המקורית

שמרו את X-Client-Request-ID שהוחזר לצורך התאמת רישומים. קראו רק ערכי task_id/asset_id שהוחזרו בפועל או את ספריית המדיה שבבעלותכם; לעולם אל תבנו URL של משימה ממזהה הפעולה ואל תשלחו שוב בקשת יצירה.

שדות התגובה

שדה	סוג
שדה`created`	סוג
שדה`data[].url`	סוג
שדה`data[].b64_json`	סוג
שדה`usage`	סוג

כינויים

כינויים למודל

Ailoot Ultra tencent/hy-image-v3.5-preview

כינויים לנתיבי שיטות

/v1/images

מזהי מודלים קשורים IDs

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview

אילו קלטים ותוצאות זמינים?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image
באילו שדות הבקשה משתמשת?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider
אילו מגבלות חלות?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Tencent: Hy Image 3.5 Preview