Mage API · نموذج صور
Mango API
عائلة الصور الرائدة لدينا
POST https://api.mage.space/v1/mango/generateلمحة سريعة
تشغّل واجهة Mango API النموذج Mango 4 و5 إصدارات أخرى عبر Mage على POST https://api.mage.space/v1/mango/generate. يكلّف الطلب بالإعدادات الافتراضية 42 Gems (حوالي 0.042$)، بدون اشتراك. يدعم Mango الشخصيات المحفوظة والمراجع عبر @handle داخل الوصف النصي.
- صورةالمخرجات
- 6الإصدارات
- 42Gems لكل صورة، الافتراضي
- $0.042التكلفة التقريبية بالدولار
نظرة عامة
ماذا تقدّم Mango API
عائلة نماذج الصور لدينا للحصول على شخصيات متسقة وتعديلات دقيقة ومشاهد مدمجة من عدة مراجع أو من Characters. يتصدر Mango 4 العائلة بأكثر إضاءة وبشرة واقعية وأوضح نصوص صغيرة؛ ويقدّم Mango 3 Turbo مسوّدات بسعر ثابت مع المراجع، ويصل Mango 3S إلى دقة 3K.
عائلة نماذج الصور الرائدة في Mage، للحصول على شخصيات متسقة وتعديلات دقيقة ومشاهد مدمجة من عدة مراجع. Mango 4 (`mango-v4`) هو الافتراضي والأحدث، بأكثر إضاءة وبشرة واقعية وأوضح نصوص صغيرة؛ و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-v4"
}' | 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-v4',
});
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-v4",
})
print(request["result"]["url"])النماذج
قيم model_id لنموذج Mango
أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.
| model_id | الاسم | افتراضي |
|---|---|---|
| mango | Mango | |
| mango-v2 | Mango 2 | |
| mango-v3s | Mango 3S | |
| mango-v3 | Mango 3 | |
| mango-v3-turbo | Mango 3 Turbo | |
| mango-v4 | Mango 4 | نعم |
الخيارات
معلمات Mango
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K, 3K, 4K |
المدخلات
مدخلات الوسائط التي يقبلها Mango
أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.
| الحقل | الدور |
|---|---|
| image | الصورة المرجعية. |
| additional_images | صور مرجعية إضافية. |
المزيد من نماذج الصور
واجهات API أخرى لإنشاء الصور على Mage
MiniMax H3 Image API
صور أصلية بدقة 16 ميغابكسل، بأوزان مفتوحة
MOSS-Image API
أوصاف طويلة ونصوص ثنائية اللغة، بأوزان مفتوحة
واجهة Nano Banana 2 API
نصوص واضحة ومقروءة حتى 4K
SDXL Plus API
SDXL بوجوه وأيدٍ مصحّحة
Seedream API
Seedream، مع فلتر صارم
Stable Diffusion v1.5 API
النموذج الكلاسيكي بتكلفة منخفضة
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Mango API؟
ما نقطة نهاية Mango API؟
ما نماذج Mango التي يمكنني استدعاؤها؟
هل يدعم Mango الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام Mango من Claude أو ChatGPT؟
ما مدة الاحتفاظ بنتائج Mango؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.