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-image | Grok Image | |
| grok-imagine-image-2.0 | Grok Image 2.0 | نعم |
الخيارات
معلمات Grok Image
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 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 |
| resolution | 1k, 2k |
المدخلات
مدخلات الوسائط التي يقبلها Grok Image
أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.
| الحقل | الدور |
|---|---|
| image | الصورة المرجعية. |
| additional_images | صور مرجعية إضافية. |
المزيد من نماذج الصور
واجهات API أخرى لإنشاء الصور على Mage
واجهة Guava API
واقعية فائقة تبدو كصورة فوتوغرافية
HiDream API
سريع ومتعدد الاستخدامات، مع أوصاف سلبية
Krea 2 API
جماليات رائعة في ثوانٍ
واجهة Mango API
عائلة الصور الرائدة لدينا
MiniMax H3 Image API
صور أصلية بدقة 16 ميغابكسل، بأوزان مفتوحة
MOSS-Image API
أوصاف طويلة ونصوص ثنائية اللغة، بأوزان مفتوحة
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Grok Image API؟
ما نقطة النهاية الخاصة بـ Grok Image API؟
ما نماذج Grok Image التي يمكنني استدعاؤها؟
هل يدعم Grok Image الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام Grok Image من Claude أو ChatGPT؟
إلى متى تُحفظ نتائج Grok Image؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.