Mage API · نموذج صور

Mango API

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

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

لمحة سريعة

تشغّل Mango API نموذج Mango 3 و4 إصدارات أخرى عبر Mage على POST https://api.mage.space/v1/mango/generate. يكلّف الطلب بالإعدادات الافتراضية 135 Gem (نحو 0.135 دولار) بدون اشتراك. يقبل Mango الشخصيات المحفوظة والمراجع عبر @handle في الوصف النصي.

نظرة عامة

ماذا تقدّم Mango API

عائلة الصور لدينا للشخصيات المتسقة والتعديلات الدقيقة والمشاهد المدمجة من مراجع كثيرة أو من Characters. يتصدر Mango 3 العائلة، ويُعد Mango 3 Turbo الأسرع والأقل تكلفة، ويصل Mango 3S إلى 3K.

عائلة الصور الرائدة في Mage، للشخصيات المتسقة والتعديلات الدقيقة والمشاهد المدمجة من مراجع كثيرة. Mango 3 (`mango-v3`) هو النموذج الحالي، وMango 3 Turbo (`mango-v3-turbo`) هو الأسرع والأقل تكلفة، وMango 3S (`mango-v3s`) يصل إلى 3K.

يقبل الحقلين image وadditional_images كمدخلات.

بداية سريعة

استدعاء Mango API

عيّن MAGE_API_KEY، وأرسل الطلب إلى /mango/generate، ثم استعلم عن status_url بشكل متكرر حتى يكتمل الطلب.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/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": "mango-v3"
}' | 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('mango', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'mango-v3',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("mango", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "mango-v3",
})

print(request["result"]["url"])

النماذج

قيم model_id لنموذج Mango

أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

model_idالاسمافتراضي
mangoMango
mango-v2Mango 2
mango-v3sMango 3S
mango-v3Mango 3نعم
mango-v3-turboMango 3 Turbo

الخيارات

معلمات Mango

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

الحقلالقيم
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

المدخلات

مدخلات الوسائط التي يقبلها Mango

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

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

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

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

صورة · من 68 Gems

واجهة Nano Banana 2 API

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

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

SDXL Plus API

SDXL بوجوه وأيدٍ مصحّحة

صورة · من 10 Gems

Stable Diffusion v1.5 API

النموذج الكلاسيكي بتكلفة منخفضة

صورة · من 10 Gems

Stable Diffusion v3.5 Large API

نسخة Stable Diffusion الأكثر التزامًا بالوصف

صورة · من 10 Gems

واجهة Stable Diffusion XL API

نموذج SDXL مضبوط للواقعية الفوتوغرافية

صورة · من 10 Gems

واجهة Z-Image API

أسرع نموذج صور على Mage

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

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

كم تبلغ تكلفة Mango API؟

يكلّف طلب Mango بالإعدادات الافتراضية (Mango 3) ‏135 Gem، أي نحو 0.135 دولار. تؤثر الدقة والمدة والإصدارات الأخرى في السعر، وتعرض الاستجابة المبلغ المحتسب بدقة. يُعاد المبلغ عند فشل عملية التوليد، ولا يُعاد إذا حجبتها سياسة المحتوى في Mage.

ما نقطة نهاية Mango API؟

أرسل طلب POST إلى https://api.mage.space/v1/mango/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url للاستعلام عنه والحصول على النتيجة.

ما نماذج Mango التي يمكنني استدعاؤها؟

mango (‏Mango)، mango-v2 (‏Mango 2)، mango-v3s (‏Mango 3S)، mango-v3 (‏Mango 3)، mango-v3-turbo (‏Mango 3 Turbo). النموذج الافتراضي هو Mango 3.

هل يدعم Mango الصور المرجعية أو الشخصيات؟

يقبل Mango المدخلين image وadditional_images. ويقبل الشخصيات المحفوظة والمراجع عبر @handle في الوصف النصي.

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

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

ما مدة الاحتفاظ بنتائج Mango؟

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

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

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

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

ذات صلة