API для разработчиков.

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

1. 1

   Создай ключ

   В профиле → API-ключи. Ключ показывается один раз.

2. 2

   Пополни баланс

   Запросы оплачиваются с того же баланса, что и чат. Цены

3. 3

   Отправь запрос

   Адрес API: https://iizy.ru/api/v1

Ключ передаётся в заголовке Authorization: Bearer sk-…. Не публикуй его в коде сайта или мобильного приложения — запросы к API делай со своего сервера.

curl https://iizy.ru/api/v1/chat/completions \
  -H "Authorization: Bearer $IISHNITSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "Ты — вежливый помощник."},
      {"role": "user", "content": "Придумай слоган для кофейни"}
    ]
  }'

Потоковый ответ

С stream: true текст приходит по мере генерации — как в чате. Если соединение оборвать, генерация остановится, а списание будет только за полученное.

stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Расскажи короткую историю"}],
    stream=True,
    stream_options={"include_usage": True},  # последний чанк — с расходом
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if chunk.usage:
        print("\nСписано, ₽:", chunk.usage.cost)

Модели и цены

Рублей за 1 млн токенов. Актуальный список с ценами — GET https://iizy.ru/api/v1/models.

Параметры запроса

POST https://iizy.ru/api/v1/chat/completions. Формат запроса и ответа — как у OpenAI Chat Completions.

model

Идентификатор модели из таблицы ниже, например deepseek-v4-flash. Обязательный.

messages

Диалог: роли system, user, assistant (developer понимается как system). Содержимое — строка или массив частей text / image_url (для моделей со зрением). Обязательный.

stream

true — ответ приходит по частям (Server-Sent Events), в конце data: [DONE].

stream_options.include_usage

true — последний чанк потока содержит usage с расходом.

max_tokens, max_completion_tokens

Предел длины ответа. По умолчанию и не больше — максимум модели.

temperature, top_p

Случайность ответа: 0–2 и 0–1.

stop

Строка или до 4 строк, на которых генерация остановится.

presence_penalty, frequency_penalty, seed

Передаются модели как есть, если она их поддерживает.

reasoning_effort

Включает рассуждение у моделей с ним (low, medium, high). Ход рассуждения приходит в reasoning_content.

Пока не поддерживаются: вызов функций (tools), несколько вариантов ответа (n > 1), эмбеддинги, генерация картинок и видео через API.

Оплата и лимиты

• — Списание по факту: токены запроса и ответа по ценам из таблицы. Сумма приходит в ответе: usage.cost, в рублях.
• — Перед запросом на балансе резервируется максимум возможной стоимости, после ответа лишнее возвращается. Если резерва не хватает — ошибка 402.
• — Бесплатный дневной лимит и безлимит подписки действуют только в чате на сайте; запросы через API оплачиваются всегда.
• — Если модель не ответила, деньги не списываются. Запрос сам переключается на резервного провайдера.
• — До 60 запросов в минуту на ключ. Нужно больше — напиши в поддержку.
• — Все списания видны в профиле, в истории операций, с названием ключа.

Ошибки

Тело ошибки — как у OpenAI: {"error": {"message", "type", "code"}}. SDK показывает его как исключение.