Public API · Beta

Публичный API
MASIX AI

Интеграция генерации изображений, редактирования и видео в свои продукты, боты и пайплайны. REST, JSON, API-ключи, вебхуки.

Генерация изображений

Текст → фото. Управление стилем, аспектом, качеством. До 4 вариантов за запрос.

Редактирование изображений

Замена фона, добавление объектов, изменение по промпту. Подаёте URL или base64.

Генерация видео

Текст → видео или анимация загруженного кадра. До 10 секунд, 1080p.

Вебхуки о готовности

Не ждите ответа в коннекте — получите POST-уведомление, когда результат готов.

Эндпоинты

База: https://api.masix.online

POST/v1/images/generateСгенерировать изображение из текстового промпта
POST/v1/images/editИзменить изображение по промпту
POST/v1/videos/generateСгенерировать видео из текста или кадра
GET/v1/jobs/{id}Узнать статус задачи и получить результат

Быстрый старт

Запустите первую генерацию за 3 шага.

  1. 01
    Получите API-ключ

    Оставьте заявку ниже — мы выдадим ключ вида sk_live_… в течение рабочего дня.

  2. 02
    Сделайте запрос

    POST на эндпоинт с заголовком Authorization: Bearer и JSON-телом.

  3. 03
    Получите результат

    Синхронно job_id + асинхронный вебхук с готовым URL изображения или видео.

curl -X POST https://api.masix.online/v1/images/generate \
  -H "Authorization: Bearer sk_live_•••" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Часы на мраморном столе, мягкий свет, премиум",
    "aspect_ratio": "1:1",
    "quality": "high",
    "n": 2,
    "webhook_url": "https://your-app.com/hooks/masix"
  }'
Синхронный ответ
{
  "id": "job_01HXYZABCDEF",
  "status": "processing",
  "type": "image.generate",
  "created_at": "2026-06-16T09:42:11Z",
  "webhook_url": "https://your-app.com/hooks/masix"
}
Вебхук о готовности
POST https://your-app.com/hooks/masix
X-Masix-Signature: t=1718531731,v1=a3f9...
Content-Type: application/json

{
  "id": "job_01HXYZABCDEF",
  "status": "succeeded",
  "type": "image.generate",
  "output": [
    { "url": "https://cdn.masix.online/out/abc.png", "width": 1024, "height": 1024 }
  ],
  "usage": { "credits": 1 }
}

Безопасность и лимиты

  • Ключи sk_live_ / sk_test_ — храните только на сервере
  • HMAC-подпись вебхуков в заголовке X-Masix-Signature
  • Идемпотентность по заголовку Idempotency-Key
  • Rate limit: 60 запросов/мин на ключ (можно поднять)
  • Файлы результатов доступны по подписанным URL 24 часа
  • Биллинг по факту: расход кредитов в /v1/usage

Получить доступ к API

API сейчас в закрытой бете. Оставьте заявку — выдадим ключ, подключим подходящий тариф и поможем с интеграцией.