API Mage · SDK
Официальные SDK для API Mage
Типизированные клиенты для TypeScript и Python и ноды Mage для ComfyUI. Все модели для изображений, видео и аудио — в нескольких строках кода.
Главное
Mage публикует SDK с открытым исходным кодом для своего API: @mage-space/sdk в npm для TypeScript и JavaScript, mage-space в PyPI для Python и набор нод comfyui-mage для ComfyUI. Каждый из них оборачивает REST API: типизированные конфиги для всех 37 моделей, автоматический опрос, идемпотентные повторы и загрузки файлов.
- 3SDK и интеграции
- 37Типизированные модели
- MITОткрытый код
- $0Для установки
Выберите свой
SDK и интеграции
npm install @mage-space/sdkSDK для TypeScript
Генерируйте изображения, видео и аудио из Node.js с типизированными конфигурациями для каждой модели Mage. Один вызов отправляет запрос, ждёт и возвращает результат.
pip install mage-spaceSDK для Python
Генерируйте изображения, видео и аудио из Python с синхронным и asyncio-клиентами и типизированными конфигурациями для каждой модели Mage.
comfy node install comfyui-mageMage для 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-v4',
});
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-v4",
})
print(request["result"]["url"])Встроено
Что каждый SDK делает за вас
Один вызов — готовый файл
run отправляет генерацию, опрашивает статус с интервалом, который рекомендует API, и возвращает завершённый запрос с result.url.
Повторы без двойной оплаты
Каждый запрос содержит ключ идемпотентности. При сетевых и серверных ошибках запрос повторяется с нарастающей задержкой, а повторная отправка никогда не оплачивается снова.
Загрузка файлов одним вызовом
Файлы, слишком большие для data URL, загружаются по подписанной ссылке: тикет, PUT-запрос и проверку размера SDK берёт на себя.
Понятные ошибки
Отказы API содержат HTTP-статус, код ошибки и идентификатор запроса; для неудачных и отменённых генераций и для тайм-аутов есть отдельные типы ошибок.
Пакеты
Где их взять
| SDK | Пакет | Установка | Исходный код |
|---|---|---|---|
| SDK для TypeScript | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| SDK для Python | mage-space | pip install mage-space | GitHub |
| Mage для ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
FAQ
Частые вопросы
SDK Mage бесплатные и с открытым кодом?
Будут ли новые модели Mage работать со старой версией SDK?
Как SDK не позволяет заплатить дважды за повторный запрос?
Стабильны ли SDK?
Сколько стоит Mage API?
Нужна ли подписка Mage, чтобы пользоваться API?
Можно ли использовать результаты API в коммерческих целях?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.