Перейти к основному содержанию

​
Авторизация

Эндпоинт поддерживает два типа авторизации с разным уровнем доступа:
ТипВидимость
API ключ (sk-...)Только генерации этого ключа
JWT токенВсе генерации организации

​
Параметры запроса

​
Пагинация

ПараметрТипПо умолчаниюОписание
pageinteger1Номер страницы (от 1)
limitinteger20Количество записей на странице (1-100)

​
Фильтрация

ПараметрТипОписание
dateFromstringДата начала периода (ISO 8601)
dateTostringДата конца периода (ISO 8601)
requestTypestringТип запроса: chat, image, video, audio
statusstringСтатус: completed, failed, pending
apiKeyIdstringID API ключа (только при JWT авторизации)
withoutApiKeybooleanПоказать генерации без API ключа (только JWT)

​
Сортировка

ПараметрТипПо умолчаниюОписание
sortBystringcreatedAtПоле: createdAt, clientCost
sortOrderstringdescНаправление: asc, desc

​
Примеры

curl "https://polza.ai/api/v1/history/generations" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Ответ (200)

{
  "items": [
    {
      "id": "gen_581761234567890123",
      "model": "gpt-4o",
      "modelDisplayName": "GPT-4o",
      "requestType": "chat",
      "provider": "openai",
      "status": "completed",
      "cost": "0.15",
      "usage": {
        "prompt_tokens": 150,
        "completion_tokens": 200,
        "total_tokens": 350
      },
      "generationTimeMs": 1500,
      "createdAt": "2025-01-15T10:30:00Z",
      "apiKeyName": "Production Key",
      "apiKeyShort": "abc123"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}

​
Поля элемента

ПолеТипОписание
idstringID генерации
modelstringSlug модели
modelDisplayNamestringОтображаемое имя модели
requestTypestringТип: chat, image, video, audio
providerstring|nullПровайдер, обработавший запрос
statusstringСтатус: completed, failed, pending
coststringСтоимость в рублях
usageobject|nullИспользование токенов
generationTimeMsnumber|nullВремя генерации в миллисекундах
createdAtstringДата создания
apiKeyNamestringИмя API ключа (при JWT авторизации)
apiKeyShortstringПоследние 6 символов ключа

​
GET Детали генерации

GET /v1/history/generations/{id}
Возвращает подробную информацию о конкретной генерации.

​
Пример

curl "https://polza.ai/api/v1/history/generations/gen_581761234567890123" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Ответ (200)

{
  "id": "gen_581761234567890123",
  "organizationId": "org_123",
  "apiKeyId": "key_456",
  "unifiedModelId": "model_789",
  "requestType": "chat",
  "apiType": "chat_completions",
  "responseMode": "sync",
  "status": "completed",
  "finishReason": "stop",
  "finalEndpointSlug": "openai",
  "usage": {
    "prompt_tokens": 150,
    "completion_tokens": 200,
    "total_tokens": 350
  },
  "clientCost": "0.15",
  "generationTimeMs": 1500,
  "latencyMs": 120,
  "queueTimeMs": 5,
  "isCancelled": false,
  "createdAt": "2025-01-15T10:30:00Z",
  "completedAt": "2025-01-15T10:30:01.500Z",
  "attemptsCount": 1
}

​
Поля ответа

ПолеТипОписание
idstringID генерации
organizationIdstringID организации
apiKeyIdstringID API ключа
unifiedModelIdstringID модели
requestTypestringТип запроса
apiTypestringТип API (chat_completions, responses, media и т.д.)
responseModestringРежим ответа (sync, stream, async)
statusstringСтатус генерации
finishReasonstringПричина завершения (stop, length, tool_calls и т.д.)
finalEndpointSlugstringПровайдер
usageobject|nullИспользование
clientCoststringСтоимость (RUB)
generationTimeMsnumber|nullВремя генерации (ms)
latencyMsnumber|nullЗадержка до первого ответа (ms)
queueTimeMsnumber|nullВремя в очереди (ms)
isCancelledbooleanБыла ли генерация отменена
createdAtstringДата создания
completedAtstring|nullДата завершения
attemptsCountnumberКоличество попыток