AGTCloud API Docs
РуководстваСправочник APIИнтеграции и ресурсыОбновления и помощь

Запрос и экспорт счетов

Выбор периода, просмотр статистики потребления и экспорт Excel.

Статистика агрегирует использование моделей, вызовы и суммы по времени. Excel служит для сохранения и офлайн-сверки.

Подготовить токен доступа

Создайте токен доступа в «Безопасности» профиля и введите его в Try It на странице Статистика счетов или Экспорт счёта.

Выбрать период и фильтры

  1. Выберите гранулярность, например «День» для суточного итога.
  2. Введите начало/конец как Unix-время в секундах либо выберите дату справа. Преобразование использует локальный часовой пояс браузера; для полного дня проверьте конечное время.
  3. Для конкретного Key или модели укажите имя; для всех совпадающих записей оставьте оба поля пустыми.
ФильтрОбязателенИспользование
Гранулярность typeДа1=минута, 2=час, 3=день, 4=неделя, 5=месяц
Начало и конецДаstartTime, endTime в секундах; конец не раньше начала
Имя API Key tokenNameНетИмя, не секрет и не токен доступа; пропуск отключает фильтр
Имя модели modelNameНетРеальное имя модели; пропуск отключает фильтр

Получить и просмотреть статистику

Отправьте фильтры в Try It для Статистики счетов. В теле code=200 означает бизнес-успех; data — агрегаты, не журнал отдельных вызовов.

  • time, timeGroup: время записи и секунды временной группы.
  • callCount, totalUseTime: число вызовов и общая длительность.
  • totalPromptTokens, totalCompletionTokens и поля кэша: входное, выходное и кэшированное использование.
  • totalAmount: сумма потребления. Поля и примеры см. в Reference; число Token не является денежной суммой.

code: 200 и data: [] означают успех без записей для выбранного периода и фильтров.

Необязательные поля могут быть null; не считайте их 0.

Экспортировать Excel

В Try It для Экспорта счёта отправьте те же фильтры. После получения файла:

  1. Проверьте период экспорта в результате.
  2. Оставьте имя с периодом или измените «Имя файла»; расширение .xlsx сохраняется автоматически.
  3. Нажмите «Скачать счёт Excel» для локального сохранения.

Даты имени используют локальный пояс браузера. Содержимое и столбцы создаёт платформа; переименование их не меняет. Для сверки статистики и экспорта используйте одинаковые период, гранулярность и фильтры.

HTTP 200 не гарантирует экспорт: обработайте JSON-ошибку, не сохраняйте её как .xlsx.

Частые вопросы

СитуацияДействие
Успех без записейПроверьте единицы времени и даты, затем очистите фильтры имён
Бизнес-код code: 401, ошибка авторизацииПроверьте токен доступа; если действительный токен не помогает, обратитесь в поддержку
Экспорт code: 400, ошибка параметровПроверьте гранулярность, начало и конец
Экспорт code: 500, ERRORПроверьте JSON и типы; при корректном вводе обратитесь к администратору
Excel не открывает файлПроверьте Content-Type: не сохранена ли JSON-ошибка как Excel

Эти бизнес-ошибки могут использовать HTTP 200. Одного HTTP-статуса недостаточно; полные примеры есть в Reference.

Текущие цены доступны на площадке моделей.

Вызов из программы

Bash-пример требует curl и jq: получение авторизации, статистика и сохранение Excel.

На этой странице