رفتن به محتوا

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نامپیش‌فرض
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 می‌پذیرد

هرکدام را به‌صورت URL با https، data URL یا آپلود تا 100 MB بفرستید.

فیلدنقش
imageتصویر مرجع.
additional_imagesتصاویر مرجع اضافی.

مدل‌های تصویر بیشتر

سایر API‌های تولید تصویر در Mage

سؤالات متداول

سؤالات متداول

هزینه API مدل Mango چقدر است؟
یک درخواست Mango با تنظیمات پیش‌فرض (Mango 3) ۱۳۵ Gems هزینه دارد، حدود $0.135. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ هزینه دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه برگردانده می‌شود؛ اما اگر سیاست محتوایی Mage آن را مسدود کند، برگردانده نمی‌شود.
اندپوینت API مدل Mango چیست؟
POST https://api.mage.space/v1/mango/generate همراه با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل یک 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. Mango شخصیت‌های ذخیره‌شده و تصاویر مرجع را با @handle در پرامپت می‌پذیرد.
آیا می‌توانم از Mango در Claude یا ChatGPT استفاده کنم؟
بله. سرور Mage MCP را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Mango را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج Mango تا چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.