Qwen: Qwen Image 3
Qwen-Image-3.0 משלב יצירה ועריכה של תמונות לפריסות עתירות מידע, לסצנות מפורטות ולטיפוגרפיה רב־לשונית. המהדורה הרגילה מאזנת בין איכות למהירות ומקבלת הנחיית טקסט או עד שלוש תמונות עם הוראת עריכה.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Qwen-Image-3.0 הוא מודל התמונות מהדור השלישי של Qwen, המשלב יצירת תמונות מטקסט ועריכה המבוססת על תמונות ייחוס במודל אחד. המהדורה הרגילה מאזנת בין איכות התמונה למהירות התגובה, ואילו Qwen-Image-3.0 Pro היא המהדורה האחות המובילה המתמקדת באיכות. בקשה מפיקה תמונה: כרזה, הסבר מאויר, סצנת מוצר, סטוריבורד או צילום מתוקן, ולא מסמך הניתן לעריכה או ממשק פעיל.
יכולותיו ליצירת תוכן עשיר מתאימות למשטח עם כמה אזורים קשורים או לפריסה חזותית מקוננת. הכינו את הכותרות, הנוסח המדויק, ההיררכיה והיחסים בין המסגרות לפני הוספת פרטים סגנוניים. להשוואת מוצרים, הנחיה שימושית מגדירה את המבט הראשי על המוצר, את המאפיינים שיש לסמן ואת סדר הקריאה של המסגרות התומכות. לסטוריבורד, תארו בנפרד את הנושא, הפעולה והכיתוב בכל מסגרת. האורך המרבי המומלץ להנחיה הוא 4,500 טוקנים; נצלו את המקום הזה לתוכן ולפריסה שהתמונה באמת צריכה.
המודל תומך במרקמים מפורטים, בטיפוגרפיה עד לטקסט קטן שהודגם בגודל 10 פיקסלים, ובהפקה ישירה ב־12 שפות עם מגוון גופנים וסגנונות אמנותיים. יכולות אלה יכולות לשלב עצם מציאותי עם גרפיקה עתירת מידע, במקום לחייב בחירה בין צילום לפריסה עמוסת טקסט. ספקו את המילים והספרות המדויקות שיש להציג, את שפתן המיועדת ואת המקום שבו עליהן להופיע. התייחסו לממשק שנוצר כאל הדמיה חזותית: כפתורים, תרשימים ותוויות שבתמונה אינם מממשים את התנהגות היישום.
עריכה יכולה לשנות טקסט, להוסיף או להסיר עצמים, להזיז רכיבים, להתאים את פעולת הנושא, להעביר סגנון או לשפר פרטים בתמונה פגומה. ספקו תמונה אחת עד שלוש והוראת עריכה ברורה אחת. מספור התמונות תואם לסדר שבו סופקו, ולכן ציינו איזו תמונה מספקת את הנושא, איזו מספקת בגד או עצם ואיזו מספקת את הסביבה. לסצנת מוצר, בקשו להציב את העצם מתמונה 1 בסביבה שבתמונה 2, תוך שמירה על המאפיינים המבדילים את המוצר. ציינו במפורש את השינויים ואת הדרישות לשימור.
תהליך קלט התמונות המדויק מקבל JPG, JPEG, PNG, BMP, TIFF, WebP ו־GIF; ב־GIF מונפש מעובדת רק המסגרת הראשונה. כל תמונה יכולה להיות בגודל של עד 10 MB. ה־API הנוכחי מקבל ממדים בין 1 ל־8,000 פיקסלים, עם יחס של עד 10:1 בין הצלע הארוכה לקצרה, וממליץ על 384–2,048 פיקסלים לתוצאות טובות. בחרו קלט שמציג בבירור את הפרטים המועברים או נערכים. תמונת ייחוס שנחתכה בצמוד לנושא עלולה להסתיר את המבנה שסביבו, הדרוש להצבת עצם באופן טבעי.
הפלט הוא PNG, עם תמונה אחת עד שש בכל בקשה ותמונה אחת כברירת מחדל. שטח הפיקסלים של הפלט נע בין 512 × 512 ל־2,048 × 2,048, עם יחסי ממדים בין 1:8 ל־8:1; אלה מגבלות שטח, ולא כלל שלפיו כל צלע חייבת להיות באורך של עד 2,048 פיקסלים. אם לא סופק גודל, המודל ממליץ על רזולוציה לפי ההנחיה. בחרו קומפוזיציה לרוחב, ריבועית או לגובה בהתאם לשימוש המיועד, ואז בדקו את התמונה שהוחזרה בגודל הזה בפועל, כדי להעריך תוויות קטנות ופרטים עדינים במקום שבו יופיעו.
שכתוב ההנחיה מופעל כברירת מחדל בתהליך של היצרן. שיפור ישיר פועל הן ביצירה והן בעריכה; שיפור באמצעות סוכן הוא מצב שכתוב מורכב יותר המיועד ליצירת תמונה מטקסט בלבד, והוא נדחה בעריכת תמונה־לתמונה. מצב החשיבה מופעל כברירת מחדל, מחייב שכתוב של ההנחיה ומאריך את זמן היצירה. הנחיות שליליות יכולות לתאר רכיבים לא רצויים, ואילו ערך seed קבוע מסייע להשוות וריאציות. ציינו בבירור מה יש להחריג ומה בדיוק חייב להישמר, במקום לצפות שערך seed יגרום להנחיה משתנה להחזיר תמונה זהה.
לתוצר סופי שימושי, בדקו את המילים שהוצגו, היחידות, סדר המסגרות והפרטים המזהים את הנושא, ואז שנו את החלק המסוים שלא עמד בהנחיה. תגובה הכוללת כמה תמונות מספקת חלופות להשוואה; שמרו כל תמונה שהוחזרה יחד עם ההנחיה ותמונות הייחוס שמהן נוצרה. כתובות התמונות של היצרן פגות לאחר 24 שעות, לכן שמרו את קובץ התמונה עצמו כשהתוצאה הופכת לחלק מפרויקט. המהדורה הרגילה 3.0 נותרת נפרדת מ־Pro וממודלי Qwen 2.1, שלהם מספרי תמונות ייחוס ויכולות שקיפות שונים.
Ailoot Ultra · תמונות POST /v1/images/generations qwen/qwen-image-3
qwen/qwen-image-3התחלה
Qwen-Image-3.0 משלב יצירה ועריכה של תמונות לפריסות עתירות מידע, לסצנות מפורטות ולטיפוגרפיה רב־לשונית. המהדורה הרגילה מאזנת בין איכות למהירות ומקבלת הנחיית טקסט או עד שלוש תמונות עם הוראת עריכה.
- סוגי קלט נתמכים
- טקסט · תמונות
- תוצאות
- תמונות
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · תמונות POST /v1/images/generations
- סוגי קלט
text,image- סוגי פלט
image
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות qwen/qwen-image-3 | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 | ברירת מחדל— |
שדהresolution | סוגstring | דרישהרשות | ערכים ומגבלות 1K, 2K | ברירת מחדל— |
שדה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 מקסימום: 6 | ברירת מחדל— |
שדהinput_references | סוגarray | דרישהרשות | ערכים ומגבלות מספר פריטים מזערי: 0 מספר פריטים מרבי: 4 | ברירת מחדל— |
שדה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 טוקנים |
| תצורהתמונת קלט | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל תמונה בקלט | חיוב קלט · תמונת קלט · אומדן להשוואה בלבד $0.006 לכל תמונה בקלט |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.06 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · תמונות
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': 'qwen/qwen-image-3', '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}/contentGET /v1/media/assetsGET /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 qwen/qwen-image-3
כינויים לנתיבי שיטות
/v1/images
מזהי מודלים קשורים IDs
FAQ · Qwen: Qwen Image 3
- אילו קלטים ותוצאות זמינים?
POST /v1/images/generations·qwen/qwen-image-3:text,image→image- באילו שדות הבקשה משתמשת?
POST /v1/images/generations·qwen/qwen-image-3:model,prompt,resolution,aspect_ratio,n,input_references,provider- אילו מגבלות חלות?
POST /v1/images/generations·qwen/qwen-image-3:n.minimum:1;n.maximum:6