Запросы

Журнал запросов к моделям: один запрос по его ID, список с фильтрами и выгрузка в CSV. Методы AITUNNEL, не OpenAI.

Эндпоинт
Авторизация
API-ключ или ключ управления с правом usage:read

Кто что видит

Чем авторизоватьсяЧто видно
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"

Поля запроса

JSON
{
  "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
}
ПолеСмысл
idID запроса, тот же, что в ответе модели
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
streamedtrue, если вы просили потоковый ответ (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"

Все параметры необязательные:

ПараметрСмысл
periodtoday, 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. Период и остальные фильтры при этом не учитываются
loggedtrue — только запросы с сохранённым логом
key_idТолько запросы этого API-ключа: номер из GET /aitunnel/keys. Работает с ключом управления; с API-ключом — 403
limitОт 1 до 100, по умолчанию 20
cursornext_cursor предыдущей страницы
JSON
{
  "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
keyAPI-ключ, которым сделан запрос: id и name. null у запросов без ключа — из Студии
jobЗадача, за которую это списание: id, kind (video или batch) и status. null у обычного запроса
next_cursorID последнего запроса страницы: передайте его в cursor, чтобы получить следующую. null — страница последняя

Значения для фильтров

GET /aitunnel/requests/filters — какие модели, методы и приложения встречаются в запросах периода: из них собирают выпадающие списки фильтров. Период задаётся как в расходе (period или from и to, по умолчанию 30 дней) и округляется до часа; key_id оставляет один ключ.

JSON
{
  "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
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.
  • Пустая ячейка — значения нет. Новые столбцы добавляются в конец.

Ошибки

КодСмысл
400ID не похож на наш: нужен вид chat- + 22 символа, как в ответе API. ID от самого провайдера (gen-…, chatcmpl-…) не подходит. У списка — неверный параметр: в error.metadata.fields названо поле
401Нет ключа или он неверный
403key_id передан с API-ключом, или у ключа управления нет права usage:read
404Запроса нет в журнале, который виден этому ключу: ID чужого ключа или аккаунта ничем не отличается от несуществующего
404
{
  "error": {
    "code": 404,
    "type": "not_found",
    "message": "Запрос не найден. Он мог быть сделан другим ключом или уже удалён из журнала.",
    "request_id": "req-0J9fQk2vXc8LrT1mNbZa4e"
  }
}

Когда запрос появляется и пропадает

  • Запись создаётся, когда запрос рассчитан. Если сразу после ответа получили 404, повторите через пару секунд. Запрос, чья стоимость уточняется у провайдера (заголовок X-AITunnel-Cost-Pending, остановленный поток), появляется позже — обычно в течение минуты.
  • Журнал хранится около трёх месяцев. Потом подробности запроса удаляются, а расход остаётся в расходе за период и кабинете.