xAI: Grok Imagine Image 2.0

ينشئ Grok Imagine Image 2.0 صورًا من موجزات مكتوبة ويحرّر الصور الموجودة عبر تعليمات باللغة الطبيعية. توثّق xAI إمكان ضبط الجودة والدقة والتكوين، واستخدام مراجع صور متعددة، ونقل الأسلوب، والتحسين التكراري.

Ailoot Ultra · الصور POST /v1/images/generations x-ai/grok-imagine-image-2.0

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Grok Imagine Image 2.0 هو نموذج xAI لتوليد الصور وتحريرها. يأخذ وصفًا مكتوبًا، أو وصفًا مع صور مصدرية، ويُرجع نتيجة على هيئة صورة. يغطي ملف 2.0 المسمّى لدى المنتج إنشاء مشهد وتغيير صورة موجودة والجمع بين موضوعات من مراجع وتحويل الأسلوب البصري. ابدأ باختيار ما إذا كنت تحتاج إلى تكوين جديد أو تغيير محدد في مادة لديك بالفعل.

إنشاء صورة من موجز

صِف الموضوع الرئيسي وبيئته والتكوين والإضاءة والمعالجة البصرية. حدّد ما ينبغي أن يلاحظه المشاهد أولًا وموضع استخدام الصورة. ولمفهوم منتج، يمكن لموجز توضيحي أن يصف مصباح مكتب خزفيًا على طاولة حجرية فاتحة، وضوء نافذة ناعمًا، ومنظرًا مقرّبًا للخامة، ومساحة مفتوحة لعنوان منفصل. ولرسم توضيحي، حدّد الشخصيات والفعل والجماليات المقصودة بدلًا من توقّع أن تحدد كلمة أسلوبية واحدة المشهد كله.

يوثّق المنتج من صورة واحدة إلى عشر صور ناتجة عن طلب توليد، مع صورة واحدة افتراضيًا. توفّر عدة نتائج من الموجز نفسه بدائل للمراجعة؛ لكنها لا تضمن موضوعًا مطابقًا في كل نسخة. افحص الموضوع والتكوين والتفاصيل المهمة، ثم احتفظ بالنسخة الأكثر ملاءمة للموجز. احتفظ بالموجز والنسخة المختارة معًا كي تستخدم التعديلات اللاحقة التكوين المقصود.

التكوين والدقة والجودة

يوثّق دليل التوليد اختيار نسبة الأبعاد تلقائيًا أو تحديد نسبة صريحة. وتشمل خياراته المدرجة 1:1 و16:9 و9:16 و4:3 و3:4 و3:2 و2:3 و2:1 و1:2 و19.5:9 و9:19.5 و20:9 و9:20 و21:9 و5:2. اختر الشكل وفق الموضع المقصود: مربعًا لبلاطة مدمجة، أو عموديًا لتكوين رأسي، أو أفقيًا لمشهد عريض. حدّد الموضوع الحساس للاقتصاص والمساحة التي يحتاج إليها التخطيط بدلًا من الاعتماد على نسبة الأبعاد وحدها.

إعدادا دقة التوليد الموثّقان هما 1k و2k، مع 1k افتراضيًا. الجودة عنصر تحكم منفصل بخيارات low وmedium وauto. وفي دليل xAI الحالي، يكون auto افتراضيًا ويستخدم low للتوليد وmedium للتحرير؛ ويثبّت إعداد low أو medium الصريح ذلك الاختيار. لذا تصف الدقة والجودة عنصرَي تحكم مختلفين. اذكر التفاصيل البصرية المهمة وافحصها في الصورة المُرجَعة بدلًا من التعامل مع أيٍّ من الإعدادين بوصفه ضمانًا لدقة الحروف أو الهندسة أو الحفاظ على الموضوع.

التحرير ونقل الأسلوب البصري

قدّم الصورة المطلوب تغييرها وصِف التغيير المطلوب بالنسبة إلى محتواها المرئي. قد يطلب تعديل محدد استبدال جدار داكن بسطح جصي فاتح مع الحفاظ على ترتيب الأثاث ومنظور الكاميرا والإضاءة الدافئة. وإذا كان المقصود تحويلًا أسلوبيًا، فحدّد المعالجة المطلوبة: يعرض المنتج أساليب التصوير الفوتوغرافي والأنمي والرسم الزيتي والألوان المائية وفن البوب والرسم بالقلم الرصاص. حدّد العناصر التي ينبغي أن تحتفظ بمظهرها والتي يمكن أن تتغير مع المعالجة.

يقبل سير عمل التحرير لدى الشركة المصنّعة مرجع صورة مصدرية أو بيانات صورة مرمّزة أو معرّف ملف. وللمراجع المخزنة، استخدم صور PNG أو JPEG أو WebP المرفوعة بالكامل. ويوثّق دليله أيضًا تعديلات متتابعة: استخدم نتيجة تعديل مدخلًا للتعديل التالي. ويمكن أن يحوّل ذلك تكوينًا أساسيًا إلى نتيجة أدق عبر تغيير الأثاث ثم تعديل الإضاءة. احتفظ بالأصل والصورة الوسيطة المختارة مرتبطَين بكل موجز كي يمكن فحص تحسين لاحق مقارنةً بالتكوين المقصود.

الجمع بين مراجع متعددة

يتيح دليل الصور المتعددة الحالي ما يصل إلى خمس صور مصدرية في تعديل واحد. أشِر إليها بترتيب تقديمها وحدّد دورًا واضحًا لكل منها، مثل الموضوع من الصورة الأولى والبيئة من الثانية. تتبع نسبة أبعاد الناتج صورة الإدخال الأولى افتراضيًا، مع إتاحة نسبة صريحة لتجاوزها. ولمفهوم منتج داخل غرفة، صِف موضع المنتج وحجمه وتلامسه مع أسطح الغرفة، ثم اطلب الحفاظ على التفاصيل التي تعرّفه. راجع كيفية دمج المصادر بدلًا من افتراض أن كل عنصر نُسخ دون تغيير.

استلام الصورة وحفظها

يُرجع المنتج عنوان صورة مؤقتًا افتراضيًا ويوثّق أيضًا إخراج الصورة المرمّزة. احفظ الصورة الفعلية سريعًا عند الحاجة إليها بوصفها مادة. يفصل سير العمل المؤجّل الاختياري بين الإقرار بالطلب وإتمامه: يتبع معرّف الطلب حالة pending أو done أو failed، وتستخدم النتائج المؤجّلة صيغة استجابة العنوان مع مدة حفظ موثّقة تبلغ 24 ساعة. تقديم طلب أو ظهور حالة pending لا يعني وجود صورة مكتملة. احتفظ بالصورة المكتملة مع موجزها والإعدادات المختارة لإعادة استخدامها لاحقًا.

المادة النهائية المفيدة صورة تناسب موجزًا محددًا لمشهد أو تخطيط أو تعديل. افحص التكوين كاملًا وتفاصيله الصغيرة، خصوصًا الموضوع المصدري وحدود العناصر والنسب وأي حروف تحمل معنى. وللعمل التكراري، غيّر التعليمة المرتبطة بالمشكلة المرئية واستخدم النتيجة المختارة مرجعًا تاليًا. اجعل التعديل المطلوب وتعليمات الحفاظ ملموسة كي يمكن تقييم كل نتيجة مقابل غرض إبداعي محدد.

Ailoot Ultra · الصور POST /v1/images/generations x-ai/grok-imagine-image-2.0

x-ai/grok-imagine-image-2.0

xAI /x-ai/grok-imagine-image-2.0

البداية

المدخلات المقبولة: النص · الصور
النتائج: الصور

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · الصور POST /v1/images/generations

الإدخال: text, image
الإخراج: image

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود x-ai/grok-imagine-image-2.0	القيمة الافتراضية—
الحقل`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	القيمة الافتراضية—
الحقل`quality`	النوع`string`	المتطلباختياري	القيم والحدود low, medium	القيمة الافتراضية—
الحقل`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.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': 'x-ai/grok-imagine-image-2.0', '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-2.0

الأسماء البديلة لمسارات الطرائق

/v1/images

معرّفات النماذج ذات الصلة IDs

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0

ما المدخلات والنتائج المتاحة؟: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image
ما الحقول التي يستخدمها الطلب؟: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider
ما الحدود المطبقة؟: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

xAI: Grok Imagine Image 2.0