Обзор API
API запроса баланса получает текущий расход квоты вашего аккаунта, включая общую квоту, использованную квоту, оставшийся баланс и количество запросов. Этот API помогает вам легко отслеживать баланс аккаунта, обеспечивая заблаговременное и гибкое управление уведомлениями о балансе.Как получить Authorization Token
1
Открыть консоль
Перейдите на
api.apiyi.com/account/profile, чтобы открыть страницу профиля2
Найдите System Token
Найдите внизу страницы раздел “Параметры учетной записи - System Token”
3
Сгенерировать AccessToken
Введите пароль учетной записи, чтобы получить AccessToken, который можно использовать для последующих API-запросов

Информация об API
Сведения о запросе
Заголовки запроса
Параметры запроса
Это GET-запрос и не требует никаких параметров тела запроса.
Детали ответа
Пример успешного ответа
Ключевые поля ответа
Преобразование квоты
Правило преобразования
500,000 quota = $1.00 USD
- Сумма в USD = quota ÷ 500,000
- Оставшаяся квота = quota (quota представляет текущий оставшийся баланс)
- Оставшиеся USD = quota ÷ 500,000
quota: 24997909→ $49.99 USD (текущий оставшийся баланс)used_quota: 10027091→ $20.05 USD (использованная сумма)
Ответы на ошибки
HTTP 401 - Ошибка аутентификации
HTTP 403 - Доступ запрещен
Примеры кода
Пример cURL
Примечание: Параметр
-s скрывает полосу прогресса, --compressed автоматически распаковывает gzip-ответПример Python (Базовый)
Пример Python (Оптимизированный)
Это добавляет следующее к базовому примеру:Обработка ошибок
Полная обработка исключений и захват ошибок
Переменные окружения
Безопасное управление token, избегайте хардкода
Форматированный вывод
Красивое отображение таблиц и форматирование чисел
Автоматическое преобразование
Автоматический расчет суммы в USD
quota.py, и он будет готов к запуску:
Часто задаваемые вопросы
Запрос баланса расходует квоту?
Запрос баланса расходует квоту?
Нет, API запроса баланса не расходует вашу квоту.
Как часто можно запрашивать баланс?
Как часто можно запрашивать баланс?
Мы рекомендуем интервал запросов не менее 1 секунды, чтобы не вызывать лимиты запросов.
Для чего нужно поле ModelFixedPrice?
Для чего нужно поле ModelFixedPrice?
Это поле возвращает информацию о тарификации для различных AI-моделей. Вы можете не обращать на него внимания, если вам нужна только информация о балансе.
Что означает поле квоты?
Что означает поле квоты?
Поле
quota показывает текущий оставшийся баланс. Если quota равно 0 или близко к 0, ваш баланс недостаточен и его нужно пополнить.Почему curl возвращает искаженный текст или jq сообщает об ошибках?
Почему curl возвращает искаженный текст или jq сообщает об ошибках?
Проблема: При выполнении curl возвращается искаженный текст, или jq сообщает «Invalid numeric literal»Причина: API возвращает содержимое, сжатое gzip (
Content-Encoding: gzip), а curl не распаковывает его автоматически.Решение: Добавьте опцию --compressed, чтобы curl автоматически распаковывал данные:Важные примечания
Лимиты запросов
- Устанавливайте разумный request timeout (рекомендуется: 10 секунд)
- Избегайте слишком частых запросов
Рекомендации по обработке исключений
- Всегда обрабатывайте сетевые исключения, timeout’ы и ошибки аутентификации
- Логируйте ошибки для более простой диагностики
Примечания к формату ответа
- API возвращает содержимое, сжатое gzip; curl требует опцию
--compressed - Библиотека requests в Python автоматически обрабатывает распаковку gzip без дополнительной настройки