انتقل إلى المحتوى

Mage API · نموذج صور

GPT Image 2 API

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

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

لمحة سريعة

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

  • صورةالمخرجات
  • 5الإصدارات
  • 9Gems لكل صورة، الافتراضي
  • $0.009التكلفة التقريبية بالدولار

نظرة عامة

ما الذي تقدّمه GPT Image 2 API

نماذج GPT Image من OpenAI، وهي تلتزم بالوصف حرفيًا وتعرض نصوصًا مقروءة. أنشئ الصور أو عدّلها انطلاقًا من عدة صور مرجعية، أو اصنع صور GIF متحركة مع GPT Image 2.6. ويُطبَّق مرشّح الأمان من OpenAI.

نماذج GPT Image من OpenAI للتوليد والتعديل: GPT Image 2 وGPT Image 2.5 Flare وSunburst وGPT Image 2.6 Flare وSunburst، وتصنع أيضًا صور GIF متحركة. ويُطبَّق مرشّح الأمان من 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.6-flareGPT Image 2.6 Flare
gpt-image-2.6-sunburstGPT Image 2.6 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
output_formatjpeg, gif

المدخلات

مدخلات الوسائط التي يقبلها GPT Image 2

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

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

القواعد

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

  • كل نموذج يوفّر بعض مستويات `quality` فقط؛ ويُرفض أي مستوى لا يوفّره النموذج المختار.
  • اضبط `output_format` على `gif` في أحد نماذج GPT Image 2.6 للحصول على صورة GIF متحركة، مع `frame_count` من 2 إلى 16 (الافتراضي 9) و`frame_duration_ms` من 20 إلى 2000 (الافتراضي 200). ترفض النماذج الأخرى ذلك. ولا ينطبق `resolution` هنا: فلكل `aspect_ratio` حجم إطار واحد، قريب من 640 بكسل. والناتج ملف `.gif`، ويبقى `type` فيه `image`.
  • يُحتسب سعر صورة GIF بحسب `quality` ونطاق عدد الإطارات الذي تقع فيه (من 2 إلى 8، أو 9، أو من 10 إلى 12، أو من 13 إلى 16)، وليس لكل إطار. يعرض جدول الأسعار أدناه الصور الثابتة، فاطّلع على سعر صورة GIF من تقدير التكلفة.
  • إذا مررت ملف GIF من Mage، مثل نتيجة سابقة، كمدخل صورة، فسيعمل على إطاره الأول. أما ملف GIF من أي مصدر آخر فيتم رفضه، لأن مدخلات الصور يجب أن تكون بصيغة JPEG أو PNG.

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

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

  • صورة · من 90 Gems

    Grok Image API

    Grok Imagine بمستويين

  • صورة · من 37 Gems

    واجهة Guava API

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

  • صورة · من 20 Gem

    HiDream API

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

  • صورة · من 20 Gem

    Krea 2 API

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

  • صورة · من 42 Gems

    واجهة Mango API

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

  • صورة · ابتداءً من 15 Gems

    MiniMax H3 Image API

    صور أصلية بدقة 16 ميغابكسل، بأوزان مفتوحة

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

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

كم تبلغ تكلفة 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.6-flare (GPT Image 2.6 Flare)، وgpt-image-2.6-sunburst (GPT Image 2.6 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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

Charactersالمجتمع