API-ключи

API-ключи используются для аутентификации запросов к ZvenoAI API.

Создание ключа

Перейдите в личный кабинет → API-ключи
Нажмите «Создать» (или «Создать первый ключ», если ключей ещё нет)
Введите название ключа (например, Production, Development)
Скопируйте сгенерированный ключ

API-ключ показывается только один раз при создании. Сохраните его в безопасном месте.

Использование

Передавайте ключ в заголовке Authorization:

Authorization: Bearer sk-your-api-key

Ключу можно задать месячный лимит расхода. Пока лимит не исчерпан, ключ работает как обычно. Когда исчерпан — отклоняются запросы этого ключа, которые создают расход. Чтение продолжает работать: каталог моделей, статус задач, уже оплаченные результаты. На остальные ключи и на баланс счёта это не влияет.

Ставьте лимит ключам, которые уходят из-под вашего контроля: в чужой код, в CI, в сторонний сервис. Утёкший ключ израсходует лимит, а не весь баланс.

Перейдите в личный кабинет → API-ключи
У нужного ключа нажмите «Задать» в строке «Лимит в месяц»
Введите сумму в рублях и сохраните

Карточка ключа показывает, сколько из лимита уже потрачено и когда счётчик обнулится. Пустое поле снимает лимит.

В лимит идёт весь расход по ключу, включая кредит подписки. Запрос без оплачиваемого результата стоит ноль и в лимит не идёт. Оборванный поток оплачивается по уже отданным токенам — этот расход в лимит тоже идёт.

Отклонённый запрос получает 402: в metadata.reason приходит api_key_budget_exceeded, там же — момент сброса. Разбор — в разделе Нехватка средств.

Безопасность

Никогда не коммитьте ключи в git
Используйте переменные окружения
Создавайте отдельные ключи для разных сред (dev/staging/prod)
Ставьте лимит расхода ключам, которые уходят наружу

.env

ZVENO_API_KEY=sk-your-api-key

app.py

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ZVENO_API_KEY"],
    base_url="https://api.zveno.ai/v1"
)

Создание ключа

Использование

Лимит расхода ключа

Безопасность

On this page