API مج · مدل تصویر
API مدل Mango
خانواده مدلهای تصویر شاخص ما
POST https://api.mage.space/v1/mango/generateدر یک نگاه
API مدل Mango، مدل Mango 3 و ۴ نسخه دیگر را از طریق Mage در POST https://api.mage.space/v1/mango/generate اجرا میکند. یک درخواست با تنظیمات پیشفرض 135 Gems (حدود $0.135) هزینه دارد، بدون نیاز به اشتراک. Mango شخصیتهای ذخیرهشده و تصاویر مرجع را با @handle در پرامپت میپذیرد.
- تصویرخروجی
- 5نسخهها
- 135Gems برای هر تصویر، پیشفرض
- $0.135حدود، به دلار
نگاه کلی
API مدل Mango چه کاری انجام میدهد
خانواده مدلهای تصویر ما برای شخصیتهای یکدست، ویرایشهای دقیق و صحنههایی که از ترکیب چندین تصویر مرجع یا 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 را بهعنوان ورودی میپذیرد.
شروع سریع
فراخوانی API مدل Mango
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 | نام | پیشفرض |
|---|---|---|
| mango | Mango | |
| mango-v2 | Mango 2 | |
| mango-v3s | Mango 3S | |
| mango-v3 | Mango 3 | بله |
| mango-v3-turbo | Mango 3 Turbo |
گزینهها
پارامترهای 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 میپذیرد
هرکدام را بهصورت URL با https، data URL یا آپلود تا 100 MB بفرستید.
| فیلد | نقش |
|---|---|
| image | تصویر مرجع. |
| additional_images | تصاویر مرجع اضافی. |
مدلهای تصویر بیشتر
سایر APIهای تولید تصویر در Mage
Nano Banana 2 API
متن شفاف و خوانا، تا 4K
API مدل SDXL Plus
SDXL با چهره و دستهای اصلاحشده
Stable Diffusion v1.5 API
کلاسیک، با هزینهٔ کم
Stable Diffusion v3.5 Large API
Stable Diffusionای که بهتر از همه به حرف شما گوش میدهد
API مدل Stable Diffusion XL
SDXL بهینهشده برای تصاویر فوتورئال
API مدل Z-Image
سریعترین مدل تصویر در Mage
سؤالات متداول
سؤالات متداول
هزینه API مدل Mango چقدر است؟
اندپوینت API مدل Mango چیست؟
کدام مدلهای Mango را میتوانم فراخوانی کنم؟
آیا Mango از تصویر مرجع یا شخصیت پشتیبانی میکند؟
آیا میتوانم از Mango در Claude یا ChatGPT استفاده کنم؟
نتایج Mango تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.