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

API Mage · SDK

Офіційні SDK для API Mage

Типізовані клієнти для TypeScript і Python та ноди Mage для ComfyUI. Усі моделі зображень, відео й аудіо в кількох рядках коду.

Отримати API-ключЧитати документацію SDK

Коротко

Mage публікує SDK з відкритим кодом для свого API: @mage-space/sdk на npm для TypeScript і JavaScript, mage-space на PyPI для Python та набір нод comfyui-mage для ComfyUI. Кожен SDK обгортає REST API типізованими конфігураціями для всіх 28 моделей, з автоматичним опитуванням, ідемпотентними повторами запитів і завантаженням файлів.

  • 3SDK та інтеграції
  • 28Типізовані моделі
  • MITВідкритий код
  • $0Для встановлення

Обери свій

SDK та інтеграції

  • npm install @mage-space/sdk

    SDK для TypeScript

    Генеруй зображення, відео й аудіо з Node.js за допомогою типізованих конфігурацій для кожної моделі Mage. Один виклик надсилає запит, чекає й повертає результат.

  • pip install mage-space

    SDK для Python

    Генеруй зображення, відео й аудіо з Python із синхронним та asyncio-клієнтами й типізованими конфігураціями для кожної моделі Mage.

  • comfy node install comfyui-mage

    Mage для ComfyUI

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

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

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

Встанови пакет, експортуй 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"])

Вбудовано

Що кожен SDK робить за тебе

  • Один виклик — готове медіа

    run надсилає генерацію, опитує API з рекомендованою затримкою (backoff) і повертає завершений запит із result.url.

  • Повтори без подвійної оплати

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

  • Завантаження одним викликом

    Файли, завеликі для data URL, надсилаються через підписане завантаження: квиток, PUT і перевірку розміру SDK бере на себе.

  • Зрозумілі помилки

    Відмови API містять HTTP-статус, код помилки та id запиту; невдалі або скасовані генерації й тайм-аути мають власні типи помилок.

Пакети

Де їх узяти

SDKПакетВстановленняДжерело
SDK для TypeScript@mage-space/sdknpm install @mage-space/sdkGitHub
SDK для Pythonmage-spacepip install mage-spaceGitHub
Mage для ComfyUIcomfyui-magecomfy node install comfyui-mageGitHub

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

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

Чи безкоштовні й відкриті SDK Mage?
Так. SDK і вузли ComfyUI мають ліцензію MIT та доступні на GitHub, а встановити їх можна безкоштовно. Ви платите лише за генерації, які запускаєте, у Gems за ціною, указаною для кожної моделі.
Чи працюють нові моделі Mage зі старішою версією SDK?
Так. Передайте id нової моделі рядком, і вона запрацює: SDK перевіряє конфігурацію за полями, спільними для всіх моделей. Бот оновлює типи щоразу, коли змінюється довідник API, тож нові моделі отримують власні типи в наступному релізі.
Як SDK уникають подвійної оплати за повторний запит?
Кожен запит містить Idempotency-Key. SDK створює новий ключ для кожного виклику й використовує його повторно, коли сам повторює цей виклик, тож повторне надсилання повертає початковий запит і не стягує плату.
Чи стабільні SDK?
Вони в бета-версії 0.x, тож другорядна версія ще може їх змінити. Версії самого API ведуться окремо, і в межах v1 він залишається стабільним.
Скільки коштує Mage API?
Жодної підписки чи щомісячної плати. Кожна генерація оплачується в Gems за ціною моделі, а 1000 Gems коштують $1 у стандартному пакеті. На сторінці кожної моделі вказана ціна за стандартних налаштувань, а у відповіді на запит показано точну суму списання. Якщо генерація не вдалася, кошти повертаються; якщо її заблокувала політика щодо контенту Mage — ні. Запит, на який не вистачає балансу, відхиляється ще до будь-якого списання.
Чи потрібна підписка на Mage, щоб користуватися API?
Ні. API працює лише на Gems. Плани підписки та безлімітна генерація в застосунку не поширюються на API-запити, тож його може викликати будь-який акаунт Mage з Gems.
Чи можна використовувати результати API в комерційних цілях?
Так. Контент, створений у Mage, зокрема через API та MCP-сервер, можна використовувати в комерційних цілях. Вказувати авторство бажано, але не обов’язково.

Створюй з Mage

Один акаунт, один баланс Gems, усі моделі. Плати лише за те, що генеруєш.

Отримати API-ключЧитати документацію SDK