Stability AI — это developer platform для генерации изображений (и смежных моделей) через REST API: аккаунт, API key, credits и вызовы v2beta. Фокус-ключ: stability ai. Канон: Getting Started, API Reference (v2beta), Pricing. Не путать с локальным Stable Diffusion: здесь облачный API Stability. Соседи: fal.ai, Replicate, Midjourney.

Ниже — маршрут новичка: аккаунт → API key → credits → первый POST на Stable Image Core. Тарифы в credits; рублевый прайс не фиксируем.

Три пути старта

Путь Суть Старт Когда
Stable Image Core базовый text-to-image POST /v2beta/stable-image/generate/core быстрый старт и прототипы
Stable Image Ultra более детальная генерация POST /v2beta/stable-image/generate/ultra когда нужен выше detail
SD 3.5 endpoint семейство Stable Diffusion 3.5 см. API Reference когда нужен именно SD 3.5
Upscale апскейл готового кадра /v2beta/stable-image/upscale/… после генерации
Credits единица оплаты API Billing + Pricing после free credits

Источник: platform.stability.ai/docs/getting-started (account, API Keys, Authorization Bearer, 25 free credits при Google login, $1 USD = 100 credits); api-reference (REST v2beta primary с March 2024; Core/Ultra multipart/form-data, Accept image/* или application/json). Сверка: 2026-10-14. ₽ не выдумываем.

Первый день со Stability API

  1. Создайте аккаунт на platform.stability.ai (email/password или Google; Google login даёт 25 free credits по Getting Started).
  2. Откройте API Keys и создайте ключ. Ключ не коммитьте и не светите в клиентском JS.
  3. Проверьте credits в кабинете; после free — покупка через Billing ($1 = 100 credits по доке).
  4. Сделайте первый запрос к Stable Image Core: multipart/form-data, заголовок Authorization: Bearer YOUR_API_KEY, Accept: image/*, поле prompt.
  5. Сохраните бинарный ответ в файл (png/webp/jpeg по output_format). При ошибках смотрите статус и тело ответа в API Reference.
export STABILITY_API_KEY="YOUR_API_KEY"
curl -X POST "https://api.stability.ai/v2beta/stable-image/generate/core" \
  -H "Authorization: Bearer $STABILITY_API_KEY" \
  -H "Accept: image/*" \
  -F prompt="a red panda sitting on a bench, soft daylight" \
  -F output_format="png" \
  -o panda.png

Primary surface — REST v2beta. Legacy gRPC / REST v1 / v2alpha поддерживаются, но новые фичи идут в v2beta. Для Core обязателен prompt; опционально negative_prompt, aspect_ratio, seed, style_preset, output_format. Не путайте облачный Stability API с локальной установкой Stable Diffusion (AUTOMATIC1111/ComfyUI) — это другой маршрут.

Core vs Ultra vs локальный SD

Core — быстрый облачный text-to-image для интеграций. Ultra — когда нужен более высокий detail на том же v2beta. Локальный Stable Diffusion (см. гайд на сайте) — свой GPU/диск, без credits Stability. Для пайплайнов «модель как API» рядом часто смотрят fal.ai и Replicate.

Типичные ошибки

  • Слать JSON вместо multipart/form-data на generate/core.
  • Забыть Accept: image/* и удивляться «странному» ответу.
  • Коммитить STABILITY_API_KEY в git или класть ключ во frontend.
  • Путать Stability Platform API с локальным Stable Diffusion.
  • Фиксировать рублевые тарифы — считайте credits и Pricing на дату запуска.

FAQ: Stability AI

Что такое Stability AI простыми словами?

Stability AI — developer platform с REST API для генерации изображений (Stable Image Core/Ultra и др.). Нужны аккаунт, API key и credits. Канон: platform.stability.ai/docs/getting-started.

С чего начать новичку?

Зарегистрируйтесь на platform.stability.ai, создайте API key, проверьте credits, затем вызовите POST /v2beta/stable-image/generate/core с Bearer-токеном и полем prompt.

Какой endpoint считать основным?

REST v2beta. Для старта обычно берут Stable Image Core: https://api.stability.ai/v2beta/stable-image/generate/core. Ultra — соседний generate/ultra.

Как устроены credits?

Credits списываются за вызовы; расход зависит от модели. По Getting Started: Google login даёт 25 free credits; дальше $1 USD = 100 credits через Billing. Рубли не фиксируем.

Чем это отличается от Stable Diffusion локально?

Stability API — облако и credits. Локальный Stable Diffusion крутится у вас (GPU/CPU) без этого биллинга. Отдельный гайд: /stable-diffusion-dlya-nachinayushchih/.

Где смотреть цены?

На platform.stability.ai/pricing и в Billing dashboard. В статье нет жёстких ₽ — сверяйте кабинет на дату запуска.

Вывод

Stability AI — аккаунт → API key → credits → v2beta Core/Ultra. Старт: Getting Started → первый generate/core → сверка Pricing. Когда нужна система обучения под креатив и интеграции — форматы на странице обучения.

Артём Денисов — эксперт Нетологии и автор курса Яндекс Практикума по промпт-инжинирингу. Сверяет Stability AI с официальной докой на дату публикации.

Хотите нейросети под свои задачи, а не «для всех»?

Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Соседи по стеку — Midjourney и fal.ai.