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 عن معامل الجودة low وmedium وauto في Grok Imagine Image 2.0. ولا ينبغي اعتبار عناصر التحكم اللاحقة في الجودة وخيارات المراجع أو نسب الأبعاد الموسّعة إعداداتٍ لهذا الملف. كما أن طلب عدة بدائل في استدعاء صور واحد يختلف عن 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
أقصى جهد للاستدلال: غير محدد عندما يُطبَّق الضبط الافتراضي 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