Справочник API

Базовый URL https://api.genmux.tech. Все запросы и ответы — JSON. Каждому запросу нужен API-ключ.

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

Создайте ключ в кабинете, экспортируйте его и выполните команды в точности как показано.

export API_KEY=nb_live_...   # from Dashboard → API keys

1. Отправьте задание

curl -s -X POST https://api.genmux.tech/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"model":"nanobanana","prompt":"a red fox in snow","resolution":"1K","ratio":"1:1"}'

Response · 202 Accepted

{
  "id": "0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d",
  "model": "nanobanana",
  "status": "queued",
  "params": {"prompt": "a red fox in snow", "n": 1, "resolution": "1K", "ratio": "1:1"},
  "cost": 2,
  "created_at": "2026-08-28T20:01:12.345Z"
}

2. Опрашивайте, пока status = succeeded (обычно 1–20 с)

curl -s https://api.genmux.tech/v1/generations/0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d \
  -H "Authorization: Bearer $API_KEY"

Response · 200 OK

{
  "id": "0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d",
  "model": "nanobanana",
  "status": "succeeded",
  "params": {"prompt": "a red fox in snow", "n": 1, "resolution": "1K", "ratio": "1:1"},
  "cost": 2,
  "images": [
    {
      "index": 0,
      "url": "https://…/0.png?X-Amz-Expires=900&…",
      "expires_at": "2026-08-28T20:16:30Z",
      "mime": "image/png",
      "width": 1024,
      "height": 1024,
      "bytes": 1843201,
      "sha256": "9f2c…"
    }
  ],
  "created_at": "2026-08-28T20:01:12.345Z",
  "finished_at": "2026-08-28T20:01:19.802Z"
}

3. Скачайте изображение (ссылка действует 15 минут)

curl -s -o fox.png "https://…/0.png?X-Amz-Expires=900&…"

Аутентификация

Передавайте ключ как bearer-токен. Ключи начинаются с nb_live_, показываются один раз при создании, их можно ротировать и отзывать в кабинете.

Authorization: Bearer $API_KEY

Опциональный список IP для ключа: запросы с других адресов получают 403 ip_not_allowed.