Запросы
Журнал запросов к моделям: один запрос по его ID, список с фильтрами и выгрузка в CSV. Методы AITUNNEL, не OpenAI.
Кто что видит
| Чем авторизоваться | Что видно |
|---|---|
| API-ключ | Только запросы, сделанные этим ключом |
Ключ управления с правом usage:read | Запросы всех ключей аккаунта и Студии. Параметр key_id оставляет один ключ |
В журнале — запросы, которые дошли до расчёта стоимости; отклонённых с ошибкой в нём нет. Хранится он около трёх месяцев.
Один запрос
GET /aitunnel/requests/{id} — стоимость, токены и время одного запроса по его ID. ID приходит в поле id ответа модели (chat-…, resp-…, msg-…, emb-…, img-… и другие) и в заголовке X-Request-Id, он же показан в логах в кабинете.
curl https://aitunnel.83.141.93.205.nip.io/__api/v1/aitunnel/requests/chat-034pYx9KaOzvCxWdvYoAvp \
-H "Authorization: Bearer sk-aitunnel-xxx"Поля запроса
{
"id": "chat-034pYx9KaOzvCxWdvYoAvp",
"object": "request",
"created_at": "2026-10-31T16:43:24.774Z",
"endpoint": "/v1/chat/completions",
"model": "deepseek-v4.1-flash-1017",
"provider": "DeepSeek",
"router": null,
"service_tier": null,
"cost_rub": 0.03,
"tool_cost_rub": null,
"parent_id": null,
"server_tool_use": null,
"log_cost_rub": null,
"cache_savings_rub": 0.26,
"discount_savings_rub": null,
"usage": {
"prompt_tokens": 9201,
"completion_tokens": 49,
"cached_tokens": 8704,
"reasoning_tokens": 49
},
"duration_ms": 761,
"streamed": true,
"ttft_ms": 318,
"finish_reason": "stop",
"user": "customer-42",
"session_id": "conv-2026-10-31-abc",
"app": "My App",
"web_search_engine": null,
"num_citations": null,
"num_fetches": null,
"log": null
}| Поле | Смысл |
|---|---|
id | ID запроса, тот же, что в ответе модели |
object | Всегда request |
created_at | Когда запрос пришёл, ISO 8601 (UTC) |
endpoint | Метод API, например /v1/chat/completions или /v1/images/edits |
model | Модель, которая обработала запрос |
provider | Провайдер, который обработал запрос, например OpenAI, Google, Amazon Bedrock. Тот же, что в карточке запроса и CSV. null, если не записан |
router | Кто выбрал модель: auto — алиас auto, имя — пресет, null — модель указана в запросе явно |
service_tier | Тариф провайдера, если был задан, иначе null |
cost_rub | Сколько списали за запрос, ₽. То же число, что usage.cost_rub в ответе модели |
tool_cost_rub | Часть стоимости за серверные инструменты: веб-поиск и поиск по базе знаний, ₽, или null |
parent_id | Запрос с серверными инструментами aitunnel:file_search и aitunnel:datetime — это несколько вызовов модели, и каждый записан отдельным запросом. У вызовов после первого здесь id первого; у остальных запросов — null |
server_tool_use | Результаты каких серверных инструментов получил этот вызов модели, например { "file_search_requests": 2 }. Их стоимость — в tool_cost_rub этого же запроса. Иначе null |
log_cost_rub | Часть стоимости за хранение запроса и ответа, ₽. 0 — запрос сохранён бесплатно (хранение 1 день), null — не сохранялся |
cache_savings_rub | Сколько сэкономил кэш промпта, ₽, или null |
discount_savings_rub | Сколько сэкономила персональная скидка, ₽, или null |
usage | Токены и единицы, которые были в запросе. Поля без значения не возвращаются |
duration_ms | Сколько запрос шёл, мс, или null |
streamed | true, если вы просили потоковый ответ (stream: true). null у методов без стрима и у запросов, записанных до появления поля |
ttft_ms | Время до первого токена потока, мс: от старта запроса до первого текста, рассуждения или вызова инструмента. Только для потока, иначе null |
finish_reason | Чем закончился ответ, как в Chat Completions: stop, length (упёрся в лимит токенов), tool_calls, content_filter, error. Для Responses и Messages приводится к тем же словам. null, если неизвестно |
user | Ваш идентификатор конечного пользователя из запроса: user или metadata.user_id у Messages, до 128 символов. См. пользователи вашего сервиса. Иначе null |
session_id | Сессия, к которой вы отнесли запрос: session_id в теле, заголовок x-session-id или сессия, которую сам шлёт агент (Claude Code, Codex, OpenCode, Kilo Code, Roo Code, Goose, Crush, OpenClaw), до 256 символов. См. session_id. Иначе null |
app | Приложение, которое отправило запрос: заголовок X-Title, иначе домен из HTTP-Referer (до 64 символов). Запросы из Студии в кабинете — studio, из Песочницы — playground. Иначе null |
web_search_engine | Поисковый движок, который вы указали в инструменте веб-поиска (parameters.engine), если поиск выполнялся. null — поиска не было или движок не указан |
num_citations | Сколько разных источников процитировал ответ после поиска, или null |
num_fetches | Сколько страниц загрузил инструмент web fetch, или null |
log | Сохранённый лог: days, expires_at и пути request, response, media (видео, иначе null). null, если запрос не сохранялся или срок истёк |
Поля usage: prompt_tokens, completion_tokens, cached_tokens, cache_write_tokens, reasoning_tokens, audio_input_tokens, audio_output_tokens, video_input_tokens, image_output_tokens, web_search_requests, video_seconds, speech_characters, transcription_seconds, embedding_inputs, rerank_documents.
Объём нетокенных методов, если он был: video_seconds (секунды видео), speech_characters (символы озвученного текста), transcription_seconds (секунды распознанного аудио), embedding_inputs (входы эмбеддингов), rerank_documents (документы в rerank).
Собственный ID запроса у провайдера не возвращается.
Список запросов
GET /aitunnel/requests — запросы, новые первыми, по странице за раз.
curl "https://aitunnel.83.141.93.205.nip.io/__api/v1/aitunnel/requests?period=7d&limit=1" \
-H "Authorization: Bearer sk-aitunnel-xxx"Все параметры необязательные:
| Параметр | Смысл |
|---|---|
period | today, yesterday, 7d, 30d, 90d, month, last_month — как в расходе. Без периода — все запросы журнала |
from, to | Свой период вместо period: дата YYYY-MM-DD (целые сутки в timezone, to включительно) или время с поясом. Здесь период читается точно, без округления до часа |
timezone | Часовой пояс IANA для дат, по умолчанию UTC |
model | Только эта модель, имя целиком |
endpoint | Только этот метод API, например /v1/chat/completions |
app | Только запросы этого приложения (поле app). none — запросы, которые приложение не назвали |
user | Поиск по вашему идентификатору пользователя: подходит любой user, в котором есть этот текст, без учёта регистра |
request_id | Один запрос по его ID. Период и остальные фильтры при этом не учитываются |
logged | true — только запросы с сохранённым логом |
key_id | Только запросы этого API-ключа: номер из GET /aitunnel/keys. Работает с ключом управления; с API-ключом — 403 |
limit | От 1 до 100, по умолчанию 20 |
cursor | next_cursor предыдущей страницы |
{
"data": [
{
"id": "chat-034pYx9KaOzvCxWdvYoAvp",
"object": "request",
"created_at": "2026-10-31T16:43:24.774Z",
"endpoint": "/v1/chat/completions",
"model": "deepseek-v4.1-flash-1017",
"provider": "DeepSeek",
"router": null,
"service_tier": null,
"cost_rub": 0.03,
"tool_cost_rub": null,
"parent_id": null,
"server_tool_use": null,
"log_cost_rub": null,
"cache_savings_rub": 0.26,
"discount_savings_rub": null,
"usage": {
"prompt_tokens": 9201,
"completion_tokens": 49,
"cached_tokens": 8704,
"reasoning_tokens": 49
},
"duration_ms": 761,
"streamed": true,
"ttft_ms": 318,
"finish_reason": "stop",
"user": "customer-42",
"session_id": "conv-2026-10-31-abc",
"app": "My App",
"web_search_engine": null,
"num_citations": null,
"num_fetches": null,
"log": null,
"key": { "id": 4217, "name": "Прод-бот" },
"job": null
}
],
"next_cursor": "chat-034pYx9KaOzvCxWdvYoAvp"
}| Поле | Смысл |
|---|---|
data | Запросы, новые первыми. У каждого — все поля одного запроса и ещё key и job |
key | API-ключ, которым сделан запрос: id и name. null у запросов без ключа — из Студии |
job | Задача, за которую это списание: id, kind (video или batch) и status. null у обычного запроса |
next_cursor | ID последнего запроса страницы: передайте его в cursor, чтобы получить следующую. null — страница последняя |
Значения для фильтров
GET /aitunnel/requests/filters — какие модели, методы и приложения встречаются в запросах периода: из них собирают выпадающие списки фильтров. Период задаётся как в расходе (period или from и to, по умолчанию 30 дней) и округляется до часа; key_id оставляет один ключ.
{
"models": ["deepseek-v4.1-flash-1017", "gpt-5.4-mini"],
"endpoints": ["/v1/chat/completions", "/v1/embeddings"],
"apps": ["My App", "studio", null]
}null в apps — запросы, которые приложение не назвали: их выбирает app=none.
Выгрузка CSV
GET /aitunnel/requests/export отдаёт те же запросы файлом text/csv. Фильтры — как у списка; limit и cursor не нужны: файл приходит целиком, запросы идут от старых к новым.
curl -o requests.csv "https://aitunnel.83.141.93.205.nip.io/__api/v1/aitunnel/requests/export?from=2026-10-01&to=2026-10-31&timezone=Europe/Moscow" \
-H "Authorization: Bearer sk-aitunnel-xxx"Без периода выгружается последний год. Столбцы, по порядку: Timestamp, Method, Model, PromptTokens, CompletionTokens, CachedTokens, CacheWriteTokens, AudioInputTokens, VideoInputTokens, ReasoningTokens, AudioOutputTokens, ImageOutputTokens, Cost, Provider, WebSearchRequests, ToolCost, CacheSavings, DurationMs, ServiceTier, DiscountSavings, RequestId, Router, Streamed, TtftMs, FinishReason, User, WebSearchEngine, Citations, Fetches, Units, SessionId, LogCost, App.
Method— метод без/v1/:chat/completions,embeddings.Cost,ToolCost,LogCost,CacheSavings,DiscountSavings— рубли.Units— объём нетокенных методов: секунды видео и аудио, символы озвучки, входы эмбеддингов, документы rerank.- Пустая ячейка — значения нет. Новые столбцы добавляются в конец.
Ошибки
| Код | Смысл |
|---|---|
400 | ID не похож на наш: нужен вид chat- + 22 символа, как в ответе API. ID от самого провайдера (gen-…, chatcmpl-…) не подходит. У списка — неверный параметр: в error.metadata.fields названо поле |
401 | Нет ключа или он неверный |
403 | key_id передан с API-ключом, или у ключа управления нет права usage:read |
404 | Запроса нет в журнале, который виден этому ключу: ID чужого ключа или аккаунта ничем не отличается от несуществующего |
{
"error": {
"code": 404,
"type": "not_found",
"message": "Запрос не найден. Он мог быть сделан другим ключом или уже удалён из журнала.",
"request_id": "req-0J9fQk2vXc8LrT1mNbZa4e"
}
}Когда запрос появляется и пропадает
- Запись создаётся, когда запрос рассчитан. Если сразу после ответа получили
404, повторите через пару секунд. Запрос, чья стоимость уточняется у провайдера (заголовокX-AITunnel-Cost-Pending, остановленный поток), появляется позже — обычно в течение минуты. - Журнал хранится около трёх месяцев. Потом подробности запроса удаляются, а расход остаётся в расходе за период и кабинете.