رفتن به محتوا

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

GPT Image 2 API

پرامپت‌های دقیق و متن خوانا

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

در یک نگاه

GPT Image 2 API مدل GPT Image 2 و 2 نسخهٔ دیگر را از طریق Mage روی POST https://api.mage.space/v1/gpt_image_2/generate اجرا می‌کند. یک درخواست با تنظیمات پیش‌فرض 9 Gem (حدود $0.009) هزینه دارد، بدون اشتراک. GPT Image 2 شخصیت‌های ذخیره‌شده و مرجع‌ها را با @handle در پرامپت می‌پذیرد.

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

نگاه کلی

GPT Image 2 API چه کارهایی انجام می‌دهد

مدل‌های GPT Image از OpenAI که پرامپت را کلمه‌به‌کلمه دنبال می‌کنند و متن خوانا می‌سازند. با تصاویر مرجع متعدد تولید یا ویرایش کنید. فیلتر ایمنی OpenAI اعمال می‌شود.

GPT Image 2، GPT Image 2.5 Flare و GPT Image 2.5 Sunburst از OpenAI، برای تولید و ویرایش تصویر. فیلتر ایمنی OpenAI اعمال می‌شود.

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

شروع سریع

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

MAGE_API_KEY را تنظیم کنید، درخواست را به /gpt_image_2/generate ارسال کنید و status_url را مرتب بررسی کنید تا درخواست کامل شود.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/gpt_image_2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "gpt-image-2"
}' | 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('gpt_image_2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'gpt-image-2',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("gpt_image_2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "gpt-image-2",
})

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

مدل‌ها

مقادیر model_id برای GPT Image 2

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

model_idنامپیش‌فرض
gpt-image-2GPT Image 2بله
gpt-image-2.5-flareGPT Image 2.5 Flare
gpt-image-2.5-sunburstGPT Image 2.5 Sunburst

گزینه‌ها

پارامترهای GPT Image 2

مقادیر مجاز برای همه نسخه‌ها؛ ممکن است یک نسخه گزینه‌های کمتری داشته باشد. گزینه‌های هر نسخه در مستندات آمده است.

فیلدمقادیر
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K

ورودی‌ها

ورودی‌های رسانه‌ای که GPT Image 2 می‌پذیرد

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

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

قوانین

قوانینی که API مدل GPT Image 2 اعمال می‌کند

  • هر مدل فقط برخی از سطوح `quality` را ارائه می‌دهد؛ سطحی که مدل انتخاب‌شده نداشته باشد رد می‌شود.

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

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

  • تصویر · از 75 Gems

    API Grok Image

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

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

    Guava API

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

  • تصویر · از 20 Gems

    API HiDream

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

  • تصویر · از 20 Gems

    Krea 2 API

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

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

    Mango API

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

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

    Nano Banana 2 API

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

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

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

هزینه API مدل GPT Image 2 چقدر است؟
یک درخواست GPT Image 2 با تنظیمات پیش‌فرض (GPT Image 2) ۹ Gems هزینه دارد، یعنی حدود $0.009. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ هزینه دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد هزینه برگردانده می‌شود، اما اگر سیاست محتوایی Mage آن را مسدود کند برگردانده نمی‌شود.
اندپوینت API مدل GPT Image 2 چیست؟
POST https://api.mage.space/v1/gpt_image_2/generate را با هدر Authorization: Bearer که کلید API شما در Mage را دارد فراخوانی کنید. پاسخ شامل یک status_url است که برای دریافت نتیجه باید مرتب بررسی شود.
کدام مدل‌های GPT Image 2 را می‌توانم فراخوانی کنم؟
gpt-image-2 (GPT Image 2)، gpt-image-2.5-flare (GPT Image 2.5 Flare)، gpt-image-2.5-sunburst (GPT Image 2.5 Sunburst). مدل پیش‌فرض GPT Image 2 است.
آیا GPT Image 2 از تصاویر مرجع یا کاراکترها پشتیبانی می‌کند؟
GPT Image 2 فیلدهای image و additional_images را می‌پذیرد. GPT Image 2 کاراکترها و مرجع‌های ذخیره‌شده را با @handle در پرامپت دریافت می‌کند.
آیا می‌توانم از GPT Image 2 در Claude یا ChatGPT استفاده کنم؟
بله. سرور MCP مربوط به Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و GPT Image 2 را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج GPT Image 2 تا چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

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

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