Grok Image API

لمحة سريعة

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

• صورة

  المخرجات

• 3

  الإصدارات

• 75

  Gems لكل صورة، الافتراضي

• $0.075

  التكلفة التقريبية بالدولار

نظرة عامة

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

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

نماذج الصور Grok Imagine من xAI بثلاث فئات جودة، للتوليد والتعديل انطلاقًا من صور مرجعية. ويُطبَّق مرشّح الأمان من xAI.

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

بداية سريعة

استدعاء Grok Image API

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

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-quality"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// 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-quality',
});

console.log(request.result.url);

# 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-quality",
})

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

النماذج

قيم model_id في Grok Image

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

الخيارات

معلمات Grok Image

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

المدخلات

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

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

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

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

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

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

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

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

ذات صلة

• واجهة API لتوليد الصور بالذكاء الاصطناعي
• مرجع Grok Image API
• مساحة تجربة Grok Image
• جميع نماذج API
• خادم Mage MCP