Перейти к основному содержанию
С помощью API Key узнайте, сколько списано за каждый вызов, и какую цену ваш аккаунт фактически платит за модель. Ни один из трёх эндпоинтов не проверяет баланс — они работают даже при нулевом балансе.

Аутентификация

string
обязательно
Используйте тот же API Key, что и для вызова моделей, с аутентификацией Bearer Token. Получить ключ можно на странице управления API Key.

Эндпоинты

Суммы указаны в USD; cost_credits и credits — в кредитах, равных USD × 10.

Одна запись по ID запроса

string
обязательно
  • Синхронные вызовы: значение заголовка ответа X-Oneapi-Request-Id
  • Асинхронные задачи: ID задачи, полученный при отправке
Журнал записывается асинхронно: обычно запись появляется через несколько секунд после завершения запроса. При ответе 404 log_not_found повторите попытку позже. Асинхронные задачи ищутся по ID задачи, и запись появляется только после её завершения или ошибки.
Поиск охватывает весь аккаунт, которому принадлежит API Key. data — массив: у одного ID могут быть и запись о списании, и запись об ошибке. Основные поля: cost_usd — окончательная сумма после расчёта: у записей об ошибках всегда 0, возврат при ошибке выполняется до записи. Сумма записей с type = consume — это всё, что списано за вызовы.

Синхронизация журнала запросов

Постранично выгружайте все записи аккаунта за период — удобно для регулярной сверки. Поля записей такие же, как при поиске одной записи.
integer
обязательно
Начало периода, Unix-время в секундах.
integer
Конец периода, Unix-время в секундах. По умолчанию — текущее время. Обе границы включаются, период не более 31 дня.
string
по умолчанию:"all"
Тип записей: all, consume или error.
string
Фильтр по названию модели.
integer
Возвращать только записи указанного API Key. ID можно скопировать в консоли в списке «API-ключи» (отображается под названием ключа); после ротации ключа ID не меняется.
integer
по умолчанию:"100"
Размер страницы, 1–1000.
string
Курсор пагинации. Передавайте next_cursor предыдущей страницы без изменений и не меняйте остальные параметры при пагинации.
В ответе has_more показывает, есть ли следующая страница, next_cursor — курсор следующей страницы, watermark — время сервера минус 300 секунд.
Рекомендуемая схема синхронизации: end_timestamp каждого запуска — не позже watermark; следующий запуск начинайте на 10 минут раньше конца предыдущего и удаляйте дубликаты по (id, type); в пределах одного окна листайте страницы, пока has_more не станет false.

Цена для аккаунта

Узнайте фактическую цену модели для аккаунта, которому принадлежит текущий API Key. Учитываются индивидуальная цена, цена программы лояльности, коэффициент группы и скидки — так же, как при списании во время вызова. На странице тарифов показаны публичные цены; для оценки стоимости по вашему аккаунту используйте этот эндпоинт.
string
обязательно
Название модели; поддерживаются псевдонимы.
string
Разрешение или уровень; должен поддерживаться моделью.
string
Размер изображения.
string
Уровень качества.
integer
Длительность в секундах, 1–3600, для моделей с посекундной оплатой.
integer
Количество результатов, 1–100.
Без параметров спецификации цена рассчитывается по спецификации модели по умолчанию. Для моделей с посекундной оплатой без duration возвращается только цена за секунду. Основные поля ответа: Не более 60 запросов в минуту на API Key.

Обработка ошибок