Перейти к содержимому
NexusAPI Docs

Changelog

Что менялось в платформе. Версионируем семантически по SemVer — patch для багфиксов, minor для новых методов/параметров, major для breaking changes. SDK имеют собственный version-bump независимо от API.

2026-06 — Self-service ограничения и аудит в панели

  • Панель: новая страница «Аудит» — лог security-событий аккаунта (логины, создание/удаление ключей, изменение ограничений). TTL 90 дней.
  • Панель: per-key аналитика — раскрытие ключа на странице «API ключи» показывает разбивку трат, запросов и моделей по конкретному ключу.
  • Панель: редактирование ограничений ключа из UI — allowed_models, allowed_ip_cidrs, rate_limit_per_min теперь self-service (раньше — только через поддержку).

2026-05 — Idempotency-Key + SDK 0.2.0

  • API: заголовок Idempotency-Key на POST /generate, POST /v1/images/generations, POST /v1/videos. TTL 24h, per-API-key namespace, кэширует 2xx + 4xx (не 5xx). Подробнее — Идемпотентность.
  • SDK 0.2.0:
    • Python: добавлен AsyncNexusClient — полный async-API под FastAPI / aiohttp / asyncio.
    • Node: новые типы ошибок TaskFailedError, NetworkError; строгая типизация запросов.
    • Auto-retries (3 попытки, экспонента + jitter, учитывает Retry-After) включены по умолчанию.
    • Auto Idempotency-Key (sdk-<uuid>) генерируется для каждого POST если клиент не передал свой.
  • PyPI: опубликовано как nexusapi-sdk (имя nexusapi зарезервировано похожим проектом). Импорт остаётся from nexusapi import ....
  • npm: опубликовано как nexusapi-sdk (имя nexusapi занято Sonatype Nexus).

2026-04 — OpenAI-совместимый /v1/*

  • API: drop-in замена OpenAI SDK через base_url=https://nexusapi.dev/v1. Поддержаны images.generate, videos.create, videos.retrieve, models.list.
  • Маппинг: OpenAI-поля (model, prompt, size, seconds) переименовываются в native (model_name, aspect_ratio, duration). extra_body прокидывает любые native-параметры (webhook_url, image_url и т.д.) — подробнее в OpenAI-совместимости.
  • Sync для image-моделей: /v1/images/generations ждёт результат до 180s — для быстрых моделей (nano-banana, sora-image) этого с запасом.

2026-03 — Seedance + рефанд при провале

  • Модели: Seedance 2.0 и 2.0-fast от ByteDance. Биллинг по токенам с post-reconcile (hold по worst-case, корректировка после получения метрик от провайдера).
  • API: автоматический refund на ключ при status=failed. Раньше клиент терял hold — теперь сумма возвращается.

Roadmap

Что ожидать в следующих итерациях (без жёстких дат):

  • YooKassa-топап через панель. Сейчас баланс пополняется через Telegram-бот; в панели появится прямой топ-ап картой/СБП.
  • Webhook signing. HMAC-подпись POST’ов на ваш callback URL для верификации источника.
  • 2FA / TOTP на customer-аккаунте.
  • Status page — публичный uptime-дашборд по эндпоинтам и провайдерам.
  • English docs — пока RU-only.

Если что-то из этого критично для твоего проекта — напиши в @nexus_keys_bot, приоритизируем.