Mage API · نموذج صور

GPT Image 2 API

أوامر نصية دقيقة ونصوص مقروءة

احصل على مفتاح APIجرّب GPT Image 2 في مساحة التجربة
POST https://api.mage.space/v1/gpt_image_2/generate

لمحة سريعة

تشغّل GPT Image 2 API نموذج GPT Image 2 وإصدارين آخرين عبر Mage على POST https://api.mage.space/v1/gpt_image_2/generate. يكلّف الطلب بالإعدادات الافتراضية 9 Gems (نحو 0.009 دولار) دون اشتراك. يقبل GPT Image 2 الشخصيات والمراجع المحفوظة عبر @handle داخل الأمر النصي.

نظرة عامة

ما الذي تقدّمه 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 كمدخلات.

بداية سريعة

استدعاء GPT Image 2 API

عيّن 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

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

الحقلالدور
imageالصورة المرجعية.
additional_imagesصور مرجعية إضافية.

القواعد

ما الذي تفرضه GPT Image 2 API

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

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

صورة · من 75 Gem

Grok Image API

Grok Imagine بثلاثة مستويات جودة

صورة · من 37 Gems

واجهة Guava API

واقعية فائقة تبدو كصورة فوتوغرافية

صورة · من 20 Gem

HiDream API

سريع ومتعدد الاستخدامات، مع أوصاف سلبية

صورة · من 20 Gem

Krea 2 API

جماليات رائعة في ثوانٍ

صورة · من 135 Gems

واجهة Mango API

عائلة الصور الرائدة لدينا

صورة · من 68 Gems

واجهة Nano Banana 2 API

نصوص واضحة ومقروءة حتى 4K

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

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

كم تبلغ تكلفة GPT Image 2 API؟

يكلّف طلب GPT Image 2 بالإعدادات الافتراضية (GPT Image 2) ‏9 Gems، أي نحو $0.009. تؤثر الدقة والمدة والإصدارات الأخرى في السعر، وتعرض الاستجابة الرسوم الدقيقة. يُسترد المبلغ عند فشل التوليد، أما التوليد الذي تحجبه سياسة المحتوى في Mage فلا يُسترد.

ما نقطة النهاية الخاصة بـ GPT Image 2 API؟

أرسل POST إلى https://api.mage.space/v1/gpt_image_2/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة 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. ويمكنه استخدام الشخصيات والمراجع المحفوظة عبر @handle في الوصف.

هل يمكنني استخدام GPT Image 2 من Claude أو ChatGPT؟

نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب GPT Image 2 بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.

إلى متى تُحفظ نتائج GPT Image 2؟

يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

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

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

احصل على مفتاح APIجرّب GPT Image 2 في مساحة التجربة

ذات صلة