API مج · مدل‌ها
۲۸ مدل تولید، یک API
همه مدل‌های تصویر، ویدیو و صدایی که API مج اجرا میکند، با کاربرد اصلی هر کدام، مقدارهای model_id و قیمت در تنظیمات پیشفرض.
POST https://api.mage.space/v1/{model}/generateدر یک نگاه
API مج ۱۵ مدل تصویر، ۱۲ مدل ویدیو و ۱ مدل صوتی را در https://api.mage.space/v1/{model}/generate اجرا میکند. همه مدل‌ها از یک کلید، یک چرخه درخواست و فیلدهای یکسان استفاده می‌کنند و هزینه هر تولید با Gems پرداخت میشود.
- 15مدل‌های تصویر
- 12مدل‌های ویدیو
- 1مدل‌های صوتی
- 1یک کلید API برای همه
مدل‌های تصویر
مدل‌های تولید تصویر
قیمت‌ها به‌ازای هر تولید و بر حسب Gem است. ۱,۰۰۰ Gem در بستهٔ استاندارد ۱ دلار است و بسته‌های بزرگ‌تر Gem جایزه دارند. قیمت به مدل، رزولوشن و مدت‌زمان بستگی دارد؛ قیمت با تنظیمات پیشفرض نمایش داده شده و هر پاسخ مبلغ دقیق را در 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 | 9 Gems ($0.009) |
| Grok Image | Grok Imagine در سه سطح کیفیت | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| 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 | 135 Gems ($0.135) |
| Nano Banana 2 | متن شفاف و خوانا، تا 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL با چهره و دست‌های اصلاح‌شده | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| 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) |
مدل‌های ویدیو
مدل‌های تولید ویدیو
| مدل | مناسب برای | مقادیر model_id | قیمت پیشفرض |
|---|---|---|---|
| Berry | ویدیویی که به مرجع‌هایتان وفادار می‌ماند | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | فریم اول و آخر را ثابت کنید | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | خانوادهٔ پرچمدار ویدیوی ما | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine در حرکت | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | ویدیوی روزمره، بدون هیچ راه‌اندازی | kiwi | 270 Gems ($0.27) |
| Lemon | همهٔ امکانات ویدیو با قیمتی مناسب‌تر | lemon | 245 Gems ($0.245) |
| LTX Video | ویدیوی سریع با وزن‌های باز برای آزمون‌وخطا | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | انیمهٔ متحرک، با صدای اختیاری | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | ویدیوی باز و سریع با صدای استریو | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | صدا روی هر کلیپ، تا 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | شخصیت‌هایی که از یک فریم اول جان می‌گیرند | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | ویدیوی با وزن‌های باز و نسخهٔ Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
مدل‌های صوتی
مدل‌های تولید صدا
| مدل | مناسب برای | مقادیر model_id | قیمت پیشفرض |
|---|---|---|---|
| Seed Audio | صدا، موسیقی و افکت صوتی از یک پرامپت | seed-audio-1.0 | 19 Gems ($0.019) |
سؤالات متداول
سؤالات متداول
هزینهی Mage API چقدر است؟
اشتراک یا هزینهی ماهانهای وجود ندارد. هر تولید با Gem و به قیمت اعلامشدهی مدلش پرداخت میشود و در بستهی استاندارد، ۱٬۰۰۰ Gem معادل ۱ دلار است. صفحهی هر مدل قیمت با تنظیمات پیشفرض را نشان میدهد و هر پاسخ مبلغ دقیق کسرشده را اعلام میکند. اگر تولیدی ناموفق باشد، هزینهاش برمیگردد؛ اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برنمیگردد. درخواستی که موجودیتان برای آن کافی نباشد، پیش از کسر هر مبلغی رد میشود.
برای استفاده از API به عضویت Mage نیاز دارم؟
نه. API فقط با Gem کار میکند. طرحهای عضویت و تولید نامحدود داخل برنامه شامل درخواستهای API نمیشوند، پس هر حساب Mage که Gem داشته باشد میتواند از آن استفاده کند.
آیا میتوانم از خروجیهای API استفاده تجاری کنم؟
بله. محتوایی که با Mage میسازید، از جمله از طریق API و سرور MCP، قابل استفادهٔ تجاری است. ذکر منبع مایهٔ قدردانی است، اما الزامی نیست.
محدودیت نرخ درخواست چقدر است؟
هر حساب میتواند همزمان ۲۰ تولید در صف یا در حال اجرا داشته باشد. ارسال بیش از این مقدار با خطای 429 رد میشود و هزینهای ندارد. برای افزایش این سقف متناسب با نیازتان به [email protected] ایمیل بزنید.
آیا ایجنت هوش مصنوعی من میتواند از API مجموعهٔ Mage استفاده کند؟
بله. ایجنتها میتوانند با یک کلید، REST API را فراخوانی کنند یا به سرور MCP مجموعهٔ Mage وصل شوند که شانزده ابزار آماده برای Claude، ChatGPT، Claude Code، Grok و Cursor فراهم میکند تا مدل انتخاب کنند، قیمت را استعلام کنند، تولید کنند و نتیجه را دریافت کنند. جزئیات: سرور MCP.
آیا برای Mage API یک SDK وجود دارد؟
بله. بستهٔ رسمی @mage-space/sdk روی npm و mage-space روی PyPI متن‌باز هستند و برای همهٔ مدل‌ها تایپ‌شده‌اند. این بسته‌ها درخواست را ارسال می‌کنند، منتظر نتیجه می‌مانند، با اطمینان دوباره تلاش می‌کنند و فایل‌ها را برایتان آپلود می‌کنند. کاربران ComfyUI میتوانند بستهٔ نودهای comfyui-mage را نصب کنند. جزئیات: SDKهای Mage.
من از قبل از API تولید دیگری استفاده می‌کنم. چه چیزی را باید تغییر بدهم؟
کلاینتتان را به https://api.mage.space/v1 وصل کنید، کلید Mage را به‌صورت Bearer token بفرستید و فیلدهایتان را با صفحهٔ مدل تطبیق دهید: prompt، aspect_ratio، resolution، duration و model_id در همهٔ مدل‌های Mage به یک شکل کار می‌کنند. درخواست‌ها ناهم‌گام‌اند؛ پس ابتدا ارسال کنید و سپس status_url را مرتب بررسی کنید.
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.