لمحة سريعة
تشغّل 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 داخل الأمر النصي.
صورة
المخرجات
3
الإصدارات
9
Gems لكل صورة، الافتراضي
$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 كمدخلات.
بداية سريعة
استدعاء 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-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
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
المدخلات
مدخلات الوسائط التي يقبلها GPT Image 2
أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.
| الحقل | الدور |
|---|---|
| image | الصورة المرجعية. |
| additional_images | صور مرجعية إضافية. |
القواعد
ما الذي تفرضه GPT Image 2 API
- كل نموذج يوفّر بعض مستويات `quality` فقط؛ ويُرفض أي مستوى لا يوفّره النموذج المختار.
المزيد من نماذج الصور
واجهات 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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.