Mage API · Моделі
28 моделей генерації, один API
Усі моделі зображень, відео й аудіо, які працюють в Mage API: для чого найкраще підходить кожна, її значення model_id та ціна за типових налаштувань.
POST https://api.mage.space/v1/{model}/generateКоротко
Mage API запускає 15 моделей зображень, 12 моделей відео та 1 модель аудіо за адресою https://api.mage.space/v1/{model}/generate. Усі моделі використовують той самий ключ, життєвий цикл запиту й назви полів, а оплата стягується за кожну генерацію в Gems.
- 15Моделі зображень
- 12Моделі відео
- 1Моделі аудіо
- 1Один API-ключ для всіх
Моделі зображень
Моделі генерації зображень
Ціни вказано за одну генерацію, у Gems. 1 000 Gems коштують $1 у стандартному пакеті, а більші пакети дають додаткові Gems. Ціна залежить від моделі, роздільної здатності та тривалості; показано ціну за стандартних налаштувань, а точну суму списання кожна відповідь містить у 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?
Жодної підписки чи щомісячної плати. Кожна генерація оплачується в Gems за ціною моделі, а 1000 Gems коштують $1 у стандартному пакеті. На сторінці кожної моделі вказана ціна за стандартних налаштувань, а у відповіді на запит показано точну суму списання. Якщо генерація не вдалася, кошти повертаються; якщо її заблокувала політика щодо контенту Mage — ні. Запит, на який не вистачає балансу, відхиляється ще до будь-якого списання.
Чи потрібна підписка на Mage, щоб користуватися API?
Ні. API працює лише на Gems. Плани підписки та безлімітна генерація в застосунку не поширюються на API-запити, тож його може викликати будь-який акаунт Mage з Gems.
Чи можна використовувати результати API в комерційних цілях?
Так. Контент, створений у Mage, зокрема через API та MCP-сервер, можна використовувати в комерційних цілях. Вказувати авторство бажано, але не обов’язково.
Які є ліміти запитів?
В одному акаунті може одночасно бути 20 генерацій у черзі або в роботі. Запит понад ліміт відхиляється з помилкою 429 і нічого не коштує. Напиши на [email protected], щоб збільшити ліміт під твій сценарій.
Чи може мій ШІ-агент користуватися API Mage?
Так. Агенти можуть викликати REST API за допомогою ключа або підключитися до MCP-сервера Mage, який дає Claude, ChatGPT, Claude Code, Grok і Cursor шістнадцять готових інструментів для вибору моделі, розрахунку ціни, генерації та отримання результату. Докладніше — про MCP-сервер.
Чи є SDK для API Mage?
Так. Офіційні пакети @mage-space/sdk на npm і mage-space на PyPI мають відкритий код і типізовані для кожної моделі. Вони самі надсилають запити, чекають на результат, безпечно повторюють спроби та завантажують файли. Користувачі ComfyUI можуть встановити набір нод comfyui-mage. Докладніше — про SDK Mage.
Я вже користуюся іншим API для генерації. Що мені потрібно змінити?
Вкажи у своєму клієнті https://api.mage.space/v1, надсилай ключ Mage як Bearer-токен і зістав свої поля зі сторінкою моделі: prompt, aspect_ratio, resolution, duration і model_id працюють однаково в усіх моделях Mage. Запити асинхронні, тому надішли запит, а потім опитуй status_url.
Створюй з Mage
Один акаунт, один баланс Gems, усі моделі. Плати лише за те, що генеруєш.