Перейти до вмісту
PlaygroundДокументаціяОтримати API-ключ

Mage API · Створено для твоєї наступної ідеї

Один API. Безмежні можливості.

Додай найкраще від Mage у свій продукт і до свого ШІ-асистента. Генеруй зображення, відео та аудіо з одним API-ключем або одним підключенням MCP.

Отримати API-ключПідключити асистентаЧитати документацію API
https://api.mage.space/v1

Коротко

Mage пропонує розробникам REST API за адресою https://api.mage.space/v1 і віддалений MCP-сервер за адресою https://mcp.mage.space/mcp. Обидва працюють з тими самими 28 моделями для зображень, відео та аудіо, зокрема з ексклюзивними для Mage Mango 3 і Cherry 2 Pro, в одному акаунті. Кожна генерація оплачується в Gems, без підписки.

  • 28Моделі
  • 3Типи медіа
  • 16Інструменти MCP
  • $0Щомісячна плата

Способи підключення

Викликай з коду, зі свого асистента або з ComfyUI

  • REST API

    Mage API

    Надсилай генерації зі свого коду за допомогою ключа. Асинхронні запити, ідемпотентні повторні спроби, завантаження файлів до 100 МБ і 20 генерацій одночасно.

  • SDK

    SDK для TypeScript і Python

    Офіційні типізовані клієнти: надсилають запит, чекають на результат, безпечно повторюють спроби й завантажують файли в кілька рядків коду.

  • MCP-сервер

    MCP-сервер Mage

    Підключи Claude, ChatGPT, Claude Code, Grok або Cursor через вхід в акаунт і замовляй зображення, відео та аудіо звичайними словами.

  • ComfyUI

    Mage для ComfyUI

    Mango, Cherry, Seed Audio та всі інші моделі Mage як вузли ComfyUI. Без GPU і завантаження моделей.

За типом медіа

API для генерації

Швидкий старт

Твоя перша генерація

Створи ключ у розділі API → API Keys, експортуй його як MAGE_API_KEY і запусти один із цих прикладів.

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"])

Як це працює

Від API-ключа до готового медіа за три виклики

Усі моделі мають одну схему автентифікації, один асинхронний життєвий цикл запиту й однакові назви полів.

  1. Створи API-ключ

    Увійди в Mage, відкрий API → API Keys і створи ключ. Він починається з mage_sk_ і показується лише один раз. В акаунті може бути 10 активних ключів.

  2. Надішли генерацію

    Надішли POST із JSON-тілом на https://api.mage.space/v1/{model}/generate із заголовком Authorization: Bearer. Відповідь приходить одразу й містить request_id, status і status_url. Додай заголовок Idempotency-Key, щоб повторна спроба ніколи не списувала оплату двічі.

  3. Опитуй і завантажуй

    Опитуй status_url, доки статус не стане completed, failed або cancelled. Завершений запит містить result.url із файлом зображення, відео чи аудіо, який зберігається 30 днів.

MCP

Mage у твоєму ШІ-асистенті

  • Mage у Claude

    Генеруй зображення, відео та аудіо в Claude у вебверсії, застосунку для комп’ютера, мобільних застосунках і Cowork.

  • Mage у ChatGPT

    Генеруй зображення, відео та аудіо в ChatGPT як персональний MCP-застосунок.

  • Mage у Claude Code

    Генеруй зображення, відео й аудіо в Claude Code — у терміналі та редакторі.

  • Mage у Grok

    Генеруй зображення, відео й аудіо в Grok через власний конектор.

  • Mage у Cursor

    Генеруй зображення, відео й аудіо в режимі Cursor Agent.

Моделі

Популярні моделі

  • Зображення · від 40 Gems

    Flux 2 API

    Довгі промпти й редагування з кількома референсами

  • Зображення · від 9 Gems

    GPT Image 2 API

    Точні промпти й читабельний текст

  • Зображення · від 37 Gems

    Guava API

    Фотореалізм, який не відрізниш від справжнього фото

  • Зображення · від 135 Gems

    Mango API

    Наша флагманська лінійка моделей для зображень

  • Зображення · від 51 Gems

    Nano Banana 2 API

    Чіткий, читабельний текст, до 4K

  • Відео · від 618 Gems

    Cherry API

    Наша флагманська лінійка моделей для відео

  • Відео · від 245 Gems

    Lemon API

    Усі відеофункції за привабливішою ціною

  • Відео · від 338 Gems

    Plum API

    Звук у кожному кліпі, до 2K

  • Аудіо · від 19 Gems

    Seed Audio API

    Голоси, музика та звукові ефекти з одного промпту

Створено для продакшну

Що отримує кожен запит до Mage API

  • Один ключ — усі моделі

    28 моделей для зображень, відео й аудіо в одному REST API з єдиним балансом Gems. Щоб змінити модель, достатньо змінити шлях в URL.

  • Оплата за кожну генерацію

    Без підписки й мінімальних витрат. Ти купуєш Gems, а за кожен запит списується його вказана ціна. Якщо генерація не вдалася, кошти повертаються — крім випадків, коли її заблокувала політика щодо контенту Mage.

  • Безпечні повторні спроби

    Ключі ідемпотентності гарантують, що повторне надсилання поверне початковий запит без повторного списання коштів.

  • Стабільні персонажі

    Збережи персонажа або референс один раз, а потім пиши @handle у будь-якому промпті, щоб використовувати його з усіма моделями, які це підтримують.

  • Великі вхідні файли

    Надсилай зображення, відео й аудіо як URL чи data URL або завантажуй файли до 100 МБ через підписане завантаження.

  • 20 генерацій одночасно

    Кожен обліковий запис може запускати 20 генерацій одночасно, а ліміт можна підвищити під твій сценарій. За відхилені запити кошти не списуються.

Поширені запитання

Поширені запитання

Що таке Mage API?
Mage API — це REST API на https://api.mage.space/v1 для генерації зображень, відео й аудіо за допомогою 28 моделей просто з твого коду. Запити асинхронні, а оплата за кожну генерацію списується в Gems.
Що таке сервер Mage MCP?
Це віддалений сервер Model Context Protocol на https://mcp.mage.space/mcp, який дає змогу ШІ-асистентам генерувати зображення, відео й аудіо у твоєму акаунті Mage. Асистент отримує 16 інструментів, щоб вибрати модель, дізнатися ціну, згенерувати, дочекатися результату та використовувати твоїх збережених персонажів, референси та історію.
Чи потрібен мені API-ключ для сервера MCP?
Ні. Claude, ChatGPT, Grok, Cursor і Claude Code підключаються через вхід у Mage за допомогою OAuth. API-ключ необов’язковий — він потрібен для безголових конфігурацій, як-от CI.
Скільки коштує 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, усі моделі. Плати лише за те, що генеруєш.

Отримати API-ключПідключити асистента