Qwen: Qwen Image 3 Pro

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

Ailoot Ultra · תמונות POST /v1/images/generations qwen/qwen-image-3-pro

על המודל

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

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

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

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

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

פורמטי הקלט הנתמכים הם JPG, JPEG, PNG, BMP, TIFF, WebP ו-GIF, ורק הפריים הראשון משמש בקובצי GIF מונפשים. כל תמונת קלט יכולה להיות בגודל עד 10 MB. ה-API המסוים מקבל צלעות מ-1 עד 8,000 פיקסלים ויחס בין הצלע הארוכה לקצרה שאינו עולה על 10:1; הטווח המומלץ שלו הוא 384–2,048 פיקסלים. מדריך העריכה ממליץ בנפרד על תמונות עד 3,072 פיקסלים, ולכן ראו בבחירת הקלט הכנה לפרטים הדרושים ולא הבטחה שכל רזולוציה משפרת את התוצאה. השתמשו בתמונת ייחוס קריאה וממוסגרת כראוי לטקסט זעיר או למאפייני חומר.

הפלטים הם PNG. תהליך היצרן מחזיר אחת עד שש חלופות, עם ברירת מחדל של אחת, ותומך בשטח פיקסלים כולל מ-512 × 512 עד 2,048 × 2,048 וביחסי רוחב-גובה מ-1:8 עד 8:1. תקציב שטח הפיקסלים מאפשר חלק מהממדים הלא ריבועיים שבהם הצלע הארוכה עולה על 2,048 פיקסלים. כשלא מוגדר גודל, המודל ממליץ על רזולוציה לפי ההנחיה. בחרו את הצורה למיקום השימוש בפועל ואז השוו את החלופות שנוצרו מבחינת שלמות התוכן, פרטי הנושא והטיפוגרפיה בגודל התצוגה המיועד.

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

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

Ailoot Ultra · תמונות POST /v1/images/generations qwen/qwen-image-3-pro

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

התחלה

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

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

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

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

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות qwen/qwen-image-3-pro	ברירת מחדל—
שדה`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.08 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

לפני הבקשה 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': 'qwen/qwen-image-3-pro', '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 qwen/qwen-image-3-pro

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

/v1/images

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

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

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

Qwen: Qwen Image 3 Pro