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-image | Grok Image | |
| grok-imagine-image-quality | Grok Image Quality | بله |
| 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 میپذیرد
هرکدام را بهصورت URL با https، data URL یا آپلود تا 100 MB بفرستید.
| فیلد | نقش |
|---|---|
| image | تصویر مرجع. |
| additional_images | تصاویر مرجع اضافی. |
مدلهای تصویر بیشتر
سایر APIهای تولید تصویر در Mage
Guava API
واقعگراییای که شبیه عکس واقعی است
API HiDream
سریع و همهکاره، با پرامپت منفی
Krea 2 API
زیبایی خیرهکننده در چند ثانیه
Mango API
خانوادهی پرچمدار ما برای تصویر
Nano Banana 2 API
متن شفاف و خوانا، تا 4K
API مدل SDXL Plus
SDXL با چهره و دستهای اصلاحشده
سؤالات متداول
سؤالات متداول
هزینه API مدل Grok Image چقدر است؟
اندپوینت API مدل Grok Image چیست؟
کدام مدلهای Grok Image را میتوانم فراخوانی کنم؟
آیا Grok Image از تصاویر مرجع یا کاراکترها پشتیبانی میکند؟
آیا میتوانم از Grok Image در Claude یا ChatGPT استفاده کنم؟
نتایج Grok Image تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.