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

Создайте API-ключ и сделайте первый запрос за 5 минут.

1. Создайте API-ключ

Для работы с Konergy API вам потребуется API-ключ. Создайте его в личном кабинете в разделе «API-ключи» → «Создать ключ».

Ключ имеет формат sk_konergy_{publicId}_{secret}, где publicId — 8 символов, secret — 32 символа.

Важно: секретная часть ключа отображается только один раз при создании. Сохраните его в надёжном месте.

2. Пополните баланс

Konergy использует модель предоплаты (prepaid wallet). Перед началом работы пополните баланс через личный кабинет.

3. Сделайте первый запрос

Отправьте изображение и получите результат в одном запросе:

bash

curl -X POST https://api.konergy.ru/api/jobs/process \
  -H "Authorization: Bearer sk_konergy_aBcD1234_your32charsecretkeyherexxxxxxxx" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Prefer: wait=30" \
  -F "image=@product.jpg"

# Ответ (200 OK):
# {
#   "jobId": "7c9e6679-...",
#   "status": "succeeded",
#   "result": { ... },
#   "error": null
# }

Заголовок Prefer: wait=30 говорит серверу подождать до 30 секунд и вернуть результат сразу. Без него сервер вернёт 202 Accepted с jobId, и вам нужно будет опрашивать GET /api/jobs/{id} для получения результата.

4. Разберитесь с биллингом

Каждый запрос тарифицируется в токенах. Стоимость зависит от размера изображения:

Формула расчёта токенов: ceil((width × height × 1.2) / 784)
Стоимость: tokens копеек (1 копейка за токен)
Тариф: 10 000 ₽ за 1 000 000 токенов

Подробнее о тарификации читайте в разделе Биллинг и цены.

Что дальше?

Аутентификация — подробнее об API-ключах и безопасности
Обработка ошибок — коды ошибок и рекомендации по обработке
Лимиты запросов — ограничения и best practices