Mage API · توليد الصور
واجهة API لتوليد الصور بالذكاء الاصطناعي لكل النماذج
تحويل النص إلى صورة، وتعديل الصور، وشخصيات متّسقة من 18 نموذجًا، منها Mango 4 النموذج الرائد في Mage، بمفتاح واحد ورصيد واحد.
POST https://api.mage.space/v1/{model}/generateلمحة سريعة
واجهة Mage لتوليد الصور هي واجهة REST API على https://api.mage.space/v1 تشغّل 18 نموذجًا لتحويل النص إلى صورة وتعديل الصور، منها Mango 4 وGuava 2 Pro وGPT Image 2.6 وNano Banana 2 وFlux 2 وKrea 2. ترسل الوصف النصي بطلب POST إلى /{model}/generate، ثم تتابع حالة الطلب وتنزّل الصورة. يُدفع ثمن كل صورة بعملة Gems دون اشتراك.
- 18نماذج صور
- $0.009أرخص سعر افتراضي لكل صورة
- 20عمليات توليد متزامنة
- $0الرسوم الشهرية
النماذج
كل نماذج الصور في Mage API
الأسعار لكل عملية توليد، بـ Gems. يكلّف 1,000 Gems دولارًا واحدًا في الباقة القياسية، وتضيف الباقات الأكبر Gems إضافية. يعتمد السعر على النموذج والدقة والمدة؛ ويظهر السعر بالإعدادات الافتراضية، وتوضح كل استجابة الرسوم الدقيقة في billing.gems_charged. تُسترد تكلفة عملية التوليد الفاشلة، أما التي تحظرها سياسة المحتوى في Mage فلا تُسترد.
| النموذج | الأنسب لـ | قيم model_id | السعر الافتراضي |
|---|---|---|---|
| Anima | مصمم خصيصًا للأنمي | anima-v1 | 20 Gems ($0.02) |
| Chroma | مفتوح الأوزان، مبني على Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | المطالبات الطويلة والتعديلات متعددة المراجع | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | مطالبات دقيقة ونص مقروء | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine بمستويين | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| Guava | واقعية تضاهي الصور الفوتوغرافية | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | سريع ومتعدد الاستخدامات، مع مطالبات سلبية | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | جماليات رائعة في ثوانٍ | krea-2-turbo | 20 Gems ($0.02) |
| Mango | عائلة الصور الرائدة لدينا | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | صور أصلية بدقة 16 ميغابكسل، بأوزان مفتوحة | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | أوصاف طويلة ونصوص ثنائية اللغة، بأوزان مفتوحة | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | نص واضح ومقروء، حتى 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL بوجوه وأيدٍ مُحسَّنة | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream، مع فلتر صارم | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| Stable Diffusion v1.5 | الكلاسيكي بسعر اقتصادي | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | نسخة Stable Diffusion الأكثر استجابة لما تكتبه | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL مضبوط للواقعية | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | أسرع نموذج صور في Mage | z-image-turbo | 10 Gems ($0.01) |
بداية سريعة
ولّد صورة باستخدام Anima v1
عيّن MAGE_API_KEY، وأرسل الطلب، ثم تابعه حتى يكتمل. استبدل anima في الرابط بأي نموذج من النماذج أعلاه.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
print(request["result"]["url"])كيف يعمل
من مفتاح API إلى وسائط جاهزة في ثلاث طلبات
تشترك جميع النماذج في نظام مصادقة واحد، ودورة طلب غير متزامنة واحدة، وأسماء الحقول نفسها.
أنشئ مفتاح API
سجّل الدخول إلى Mage، وافتح API ← API Keys، وأنشئ مفتاحًا. يبدأ بـ mage_sk_ ويظهر مرة واحدة فقط. يمكن للحساب الواحد الاحتفاظ بـ 10 مفاتيح نشطة.
أرسل طلب توليد
أرسل طلب POST بجسم JSON إلى https://api.mage.space/v1/{model}/generate مع ترويسة Authorization: Bearer. تعود الاستجابة فورًا مع request_id وstatus وstatus_url. أضف ترويسة Idempotency-Key حتى لا تدفع مرتين عند إعادة المحاولة.
تحقّق ثم نزّل
استعلم عن status_url إلى أن تصبح الحالة completed أو failed أو cancelled. يحتوي الطلب المكتمل على result.url الذي يشير إلى ملف الصورة أو الفيديو أو الصوت، ويُحفظ لمدة 30 يومًا.
جاهزة للإنتاج
ما يحصل عليه كل طلب إلى Mage API
مفتاح واحد لكل النماذج
37 نموذجًا للصور والفيديو والصوت عبر واجهة REST API واحدة ورصيد Gems واحد. بدّل النموذج بتغيير مسار الرابط.
ادفع مقابل كل عملية إنشاء
بلا اشتراك وبلا حد أدنى للإنفاق. تشتري Gems ويُحتسب على كل طلب سعره المعلن. وإذا فشلت عملية الإنشاء يُسترد المبلغ، إلا إذا حظرتها سياسة المحتوى في Mage.
إعادة محاولة آمنة
تتيح مفاتيح عدم التكرار (Idempotency keys) إعادة إرسال الطلب لتحصل على الطلب الأصلي نفسه دون خصم جديد.
شخصيات متسقة
احفظ شخصية أو مرجعًا مرة واحدة، ثم اكتب @handle في أي أمر لاستخدامه مع كل نموذج يدعم ذلك.
مدخلات كبيرة
أرسل مدخلات الصور والفيديو والصوت كروابط URL أو data URL، أو ارفع ملفات حتى 100 MB عبر رفع موقّع.
20 عملية إنشاء متزامنة
يمكن لكل حساب تشغيل 20 عملية إنشاء في وقت واحد، ويمكن رفع هذا الحد بما يناسب حالتك. الطلبات المرفوضة لا تُحتسب أبدًا.
حالات الاستخدام
ما يبنيه المطورون باستخدام واجهة الصور
صور المنتجات والتسويق
أنشئ صور المنتجات ونسخ الإعلانات ومنشورات التواصل الاجتماعي وقتما تشاء، مع نصوص مقروءة بفضل GPT Image 2.6 أو Nano Banana 2.
شخصيات متسقة
احفظ الشخصية مرة واحدة وأبقِ الوجه نفسه في مجموعة كاملة من الصور مع Mango 4 وGuava 2 Pro وغيرهما من النماذج التي تدعم الإشارة عبر @handle.
مسارات تحرير الصور
أرسل صورة أصلية مع تعليمات لتغيير ما تطلبه بالضبط وإبقاء بقية الصورة كما هي.
التطبيقات والألعاب
أنشئ صورًا رمزية وملصقات وبطاقات ومشاهد داخل منتجك دون استضافة أي وحدة GPU.
بورتريهات واقعية
يُنتج Guava 2 Pro بورتريهات ولقطات أزياء وأسلوب حياة ببشرة وأقمشة وإضاءة تشبه الواقع تمامًا.
مسودات سريعة بكميات كبيرة
يحافظ Z-Image Turbo وKrea 2 على أسعار منخفضة للصور المصغرة والمحاولات الأولى بكميات كبيرة.
الأسئلة الشائعة
الأسئلة الشائعة
ما أفضل واجهة API لتوليد الصور بالذكاء الاصطناعي؟
هل تدعم واجهة API للصور تحرير الصور والصور المرجعية؟
ما الدقة التي تدعمها واجهة API للصور؟
كم تبلغ تكلفة Mage API؟
هل أحتاج إلى عضوية في Mage لاستخدام API؟
هل يمكنني استخدام مخرجات API تجاريًا؟
ما حدود معدّل الطلبات؟
هل يمكن لوكيل الذكاء الاصطناعي الخاص بي استخدام واجهة Mage API؟
هل توجد حزمة SDK لواجهة Mage API؟
أستخدم واجهة توليد أخرى بالفعل. ماذا عليّ أن أغيّر؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.