انتقل إلى المحتوى

Mage API · نموذج صور

Grok Image API

Grok Imagine بمستويين

POST https://api.mage.space/v1/grok_image/generate

لمحة سريعة

تشغّل واجهة Grok Image API النموذج Grok Image 2.0 ونسخة أخرى واحدة عبر Mage على POST https://api.mage.space/v1/grok_image/generate. يكلّف الطلب بالإعدادات الافتراضية 90 Gems (نحو $0.09) دون اشتراك. يقبل Grok Image الشخصيات المحفوظة والمراجع عبر @handle داخل الوصف.

  • صورةالمخرجات
  • 2الإصدارات
  • 90Gems لكل صورة، الافتراضي
  • $0.09التكلفة التقريبية بالدولار

نظرة عامة

ما الذي تقدّمه Grok Image API

نموذج الصور Grok Imagine من xAI بمستويين. يولّد صورًا أو يعدّلها انطلاقًا من 3 صور مرجعية كحد أقصى مع الحفاظ على تفاصيل المصدر كما هي. يسري مرشّح الأمان الخاص بـ xAI.

نماذج الصور Grok Imagine من xAI بمستويين، للتوليد والتعديل انطلاقًا من صور مرجعية: Grok Image 2.0 (`grok-imagine-image-2.0`) وهو الافتراضي، وGrok Image (`grok-imagine-image`) للمسودات الاقتصادية. أوقفت xAI نموذج Grok Image Quality (`grok-imagine-image-quality`) في 2 نوفمبر 2026، ويُرفض أي طلب يذكره. يسري مرشّح الأمان الخاص بـ xAI.

يقبل الحقلين image وadditional_images كمدخلات.

بداية سريعة

استدعاء Grok Image API

عيّن MAGE_API_KEY، وأرسل الطلب إلى /grok_image/generate، ثم تحقق من status_url بشكل متكرر حتى يكتمل الطلب.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_image/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "1:1",
  "model_id": "grok-imagine-image-2.0"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('grok_image', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '1:1',
  model_id: 'grok-imagine-image-2.0',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("grok_image", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "1:1",
    "model_id": "grok-imagine-image-2.0",
})

print(request["result"]["url"])

النماذج

قيم model_id في Grok Image

أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

model_idالاسمافتراضي
grok-imagine-imageGrok Image
grok-imagine-image-2.0Grok Image 2.0نعم

الخيارات

معلمات Grok Image

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

الحقلالقيم
aspect_ratio1: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
resolution1k, 2k

المدخلات

مدخلات الوسائط التي يقبلها Grok Image

أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.

الحقلالدور
imageالصورة المرجعية.
additional_imagesصور مرجعية إضافية.

المزيد من نماذج الصور

واجهات API أخرى لإنشاء الصور على Mage

  • صورة · من 37 Gems

    واجهة Guava API

    واقعية فائقة تبدو كصورة فوتوغرافية

  • صورة · من 20 Gem

    HiDream API

    سريع ومتعدد الاستخدامات، مع أوصاف سلبية

  • صورة · من 20 Gem

    Krea 2 API

    جماليات رائعة في ثوانٍ

  • صورة · من 42 Gems

    واجهة Mango API

    عائلة الصور الرائدة لدينا

  • صورة · ابتداءً من 15 Gems

    MiniMax H3 Image API

    صور أصلية بدقة 16 ميغابكسل، بأوزان مفتوحة

  • صورة · من 25 Gems

    MOSS-Image API

    أوصاف طويلة ونصوص ثنائية اللغة، بأوزان مفتوحة

الأسئلة الشائعة

الأسئلة الشائعة

كم تبلغ تكلفة Grok Image API؟
يكلّف طلب Grok Image بالإعدادات الافتراضية (Grok Image 2.0) ‏90 Gems، أي نحو $0.09. تؤثر الدقة والمدة والنسخ الأخرى في السعر، وتعرض الاستجابة المبلغ المحتسب بدقة. يُردّ المبلغ عند فشل التوليد، أما التوليد الذي تحجبه سياسة المحتوى في Mage فلا يُردّ.
ما نقطة النهاية الخاصة بـ Grok Image API؟
أرسل POST إلى https://api.mage.space/v1/grok_image/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url للتحقق من النتيجة.
ما نماذج Grok Image التي يمكنني استدعاؤها؟
grok-imagine-image (Grok Image)، وgrok-imagine-image-2.0 (Grok Image 2.0). النموذج الافتراضي هو Grok Image 2.0.
هل يدعم Grok Image الصور المرجعية أو الشخصيات؟
يقبل Grok Image المعلمتين image وadditional_images. ويمكنه استخدام الشخصيات والمراجع المحفوظة عبر @handle في الوصف.
هل يمكنني استخدام Grok Image من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Grok Image بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
إلى متى تُحفظ نتائج Grok Image؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

Charactersالمجتمع