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-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
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
| output_format | jpeg, 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
Grok Image API
Grok Imagine بمستويين
واجهة Guava API
واقعية فائقة تبدو كصورة فوتوغرافية
HiDream API
سريع ومتعدد الاستخدامات، مع أوصاف سلبية
Krea 2 API
جماليات رائعة في ثوانٍ
واجهة Mango API
عائلة الصور الرائدة لدينا
MiniMax H3 Image API
صور أصلية بدقة 16 ميغابكسل، بأوزان مفتوحة
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة GPT Image 2 API؟
ما نقطة النهاية الخاصة بـ GPT Image 2 API؟
ما نماذج GPT Image 2 التي يمكنني استدعاؤها؟
هل يدعم GPT Image 2 الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام GPT Image 2 من Claude أو ChatGPT؟
إلى متى تُحفظ نتائج GPT Image 2؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.