رفتن به محتوا

API مج · مدل تصویر

API مدل Grok Image

Grok Imagine در سه سطح کیفیت

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

در یک نگاه

API مدل Grok Image، مدل Grok Image Quality و ۲ نسخه دیگر را از طریق Mage در POST https://api.mage.space/v1/grok_image/generate اجرا می‌کند. یک درخواست با تنظیمات پیش‌فرض 75 Gems (حدود $0.075) هزینه دارد، بدون اشتراک. Grok Image کاراکترها و مرجع‌های ذخیره‌شده را با @handle در پرامپت دریافت می‌کند.

  • تصویرخروجی
  • 3نسخه‌ها
  • 75Gems برای هر تصویر، پیش‌فرض
  • $0.075حدود، به دلار

نگاه کلی

API مدل Grok Image چه کاری انجام می‌دهد

مدل تصویر Grok Imagine از xAI در سه سطح کیفیت. با حداکثر ۳ تصویر مرجع تصویر می‌سازد یا ویرایش می‌کند و جزئیات تصویر اصلی را حفظ می‌کند. فیلتر ایمنی xAI اعمال می‌شود.

مدل‌های تصویر Grok Imagine از xAI در سه سطح کیفیت، برای تولید و ویرایش از روی تصاویر مرجع. فیلتر ایمنی xAI اعمال می‌شود.

image و additional_images را به‌عنوان ورودی می‌پذیرد.

شروع سریع

فراخوانی API مدل Grok Image

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

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

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

مدل‌ها

مقادیر model_id برای Grok Image

برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیش‌فرض را اجرا می‌کند.

model_idنامپیش‌فرض
grok-imagine-imageGrok Image
grok-imagine-image-qualityGrok Image Qualityبله
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 می‌پذیرد

هرکدام را به‌صورت URL با https، data URL یا آپلود تا 100 MB بفرستید.

فیلدنقش
imageتصویر مرجع.
additional_imagesتصاویر مرجع اضافی.

مدل‌های تصویر بیشتر

سایر API‌های تولید تصویر در Mage

  • تصویر · از ۳۷ Gem

    Guava API

    واقع‌گرایی‌ای که شبیه عکس واقعی است

  • تصویر · از 20 Gems

    API HiDream

    سریع و همه‌کاره، با پرامپت منفی

  • تصویر · از 20 Gems

    Krea 2 API

    زیبایی خیره‌کننده در چند ثانیه

  • تصویر · از ۱۳۵ Gem

    Mango API

    خانواده‌ی پرچم‌دار ما برای تصویر

  • تصویر · از ۵۱ Gem

    Nano Banana 2 API

    متن شفاف و خوانا، تا 4K

  • تصویر · از 15 Gems

    API مدل SDXL Plus

    SDXL با چهره و دست‌های اصلاح‌شده

سؤالات متداول

سؤالات متداول

هزینه API مدل Grok Image چقدر است؟
یک درخواست Grok Image با تنظیمات پیش‌فرض (Grok Image Quality) 75 Gems هزینه دارد، یعنی حدود $0.075. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ هزینه دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد هزینه برگردانده می‌شود، اما اگر سیاست محتوایی Mage آن را مسدود کند برگردانده نمی‌شود.
اندپوینت API مدل Grok Image چیست؟
POST https://api.mage.space/v1/grok_image/generate را با هدر Authorization: Bearer که کلید API شما در Mage را دارد فراخوانی کنید. پاسخ شامل یک status_url است که برای دریافت نتیجه باید مرتب بررسی شود.
کدام مدل‌های Grok Image را می‌توانم فراخوانی کنم؟
grok-imagine-image (Grok Image)، grok-imagine-image-quality (Grok Image Quality)، grok-imagine-image-2.0 (Grok Image 2.0). مدل پیش‌فرض Grok Image Quality است.
آیا Grok Image از تصاویر مرجع یا کاراکترها پشتیبانی می‌کند؟
Grok Image فیلدهای image و additional_images را می‌پذیرد. Grok Image کاراکترها و مرجع‌های ذخیره‌شده را با @handle در پرامپت دریافت می‌کند.
آیا می‌توانم از Grok Image در Claude یا ChatGPT استفاده کنم؟
بله. سرور MCP مربوط به Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Grok Image را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج Grok Image تا چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.