SpaceXAI: Grok Imagine Image Quality

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

Ailoot Ultra · תמונות POST /v1/images/generations x-ai/grok-imagine-image-quality

על המודל

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

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

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

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

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

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

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

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

המודל הנקרא Image Quality נפרד מהפרמטר של Grok Imagine Image 2.0 לבחירת איכות low, medium ו־auto. אין להתייחס לבקרות האיכות המאוחרות האלה, או לאפשרויות הייחוס ויחסי התמונה המורחבות, כהגדרות של פרופיל זה. בקשת כמה חלופות בקריאת תמונה אחת שונה גם מ־Batch API של היצרן, שעמוד מודל Quality המדויק אינו מציין תמיכה בו. בתהליך שניתן לשחזר, שימרו יחד את בחירת המודל, ההנחיה, תמונות הייחוס והפלט שנבחר.

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

Ailoot Ultra · תמונות POST /v1/images/generations x-ai/grok-imagine-image-quality

x-ai/grok-imagine-image-quality

SpaceXAI /x-ai/grok-imagine-image-quality

התחלה

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

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

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

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

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות x-ai/grok-imagine-image-quality	ברירת מחדל—
שדה`prompt`	סוג`string`	דרישהחובה	ערכים ומגבלות אורך מזערי: ⁦1⁩	ברירת מחדל—
שדה`resolution`	סוג`string`	דרישהרשות	ערכים ומגבלות 1K, 2K	ברירת מחדל—
שדה`aspect_ratio`	סוג`string`	דרישהרשות	ערכים ומגבלות 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto	ברירת מחדל—
שדה`n`	סוג`integer`	דרישהרשות	ערכים ומגבלות מינימום: ⁦1⁩ מקסימום: ⁦1⁩	ברירת מחדל—
שדה`input_references`	סוג`array`	דרישהרשות	ערכים ומגבלות מספר פריטים מזערי: ⁦0⁩ מספר פריטים מרבי: ⁦3⁩	ברירת מחדל—
שדה`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.02 לכל תמונה בקלט
תצורהעלות יצירה משוערת	טבלת תעריפים—	כמות חזויהאומדן ליצירה אחת	יחידת חיוב—	חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.1 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

לפני הבקשה 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': 'x-ai/grok-imagine-image-quality', '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 x-ai/grok-imagine-image-quality

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

/v1/images

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

x-ai/grok-imagine-image-quality

FAQ · SpaceXAI: Grok Imagine Image Quality

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

SpaceXAI: Grok Imagine Image Quality