# Анализированное видео

## Получить URL анализированного видео

> Получает URL анализированного видео для конкретной сессии или пытается создать его, если он не существует.\
> \### Параметр пути\
> \- \*\*session\_id\*\* \*(строка, обязательно)\*: Уникальный идентификатор сессии.\
> \### Параметры запроса\
> Эти необязательные флаги определяют тип анализа, если видео не существует:\
> \- \*\*is\_jump\*\* \*(логический, опционально)\*: Указывает, является ли эта сессия для анализа прыжка.\
> \- \*\*is\_weight\*\* \*(логический, опционально)\*: Указывает, является ли эта сессия для анализа тяжелой атлетики.\
> \- \*\*download\*\* \*(логический, опционально)\*: Если \`true\`, возвращает подписанный URL, который заставляет браузер скачать видео вместо его отображения.\
> \### Ответ (HTTP 200)\
> Возвращает JSON-объект с ключом \`analyzed\_video\_url\` при успехе:\
> \`\`\`json {\
> &#x20; "analyzed\_video\_url": "<https://storage.googleapis.com/.../analyzed\\_video.mp4"\\>
> } \`\`\`\
> \### Обработка ошибок\
> \- \*\*400 Bad Request\*\*: Некорректные параметры (например, отсутствующий или неверный UID администратора).\
> \- \*\*401 Unauthorized\*\*: Токен отсутствует или недействителен.\
> \- \*\*403 Forbidden\*\*: У пользователя нет необходимых прав или плана.\
> \- \*\*404 Not Found\*\*: Данные сессии или ресурсы не найдены.\
> \- \*\*500 Internal Server Error\*\*: Непредвиденная ошибка на сервере.\
> \### Безопасность\
> В заголовке \`Authorization\` должен быть указан действительный API-KEY токен.<br>

````json
{"openapi":"3.1.1","info":{"title":"AIKYNETIX WEB API","version":"v2"},"servers":[{"url":"https://api.aikynetix.app"}],"security":[{"Bearer":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header","description":"Укажите ваш Bearer-токен (Firebase auth) в формате: Bearer <токен>"},"ApiKeyAuth":{"type":"apiKey","name":"API-KEY","in":"header","description":"Укажите ваш API-ключ в заголовке: API-KEY: <api_key>"}}},"paths":{"/session-management/sessions/{session_id}/analyzed-video/":{"get":{"operationId":"session-management_sessions_analyzed-video_list","summary":"Получить URL анализированного видео","description":"Получает URL анализированного видео для конкретной сессии или пытается создать его, если он не существует.\n### Параметр пути\n- **session_id** *(строка, обязательно)*: Уникальный идентификатор сессии.\n### Параметры запроса\nЭти необязательные флаги определяют тип анализа, если видео не существует:\n- **is_jump** *(логический, опционально)*: Указывает, является ли эта сессия для анализа прыжка.\n- **is_weight** *(логический, опционально)*: Указывает, является ли эта сессия для анализа тяжелой атлетики.\n- **download** *(логический, опционально)*: Если `true`, возвращает подписанный URL, который заставляет браузер скачать видео вместо его отображения.\n### Ответ (HTTP 200)\nВозвращает JSON-объект с ключом `analyzed_video_url` при успехе:\n```json {\n  \"analyzed_video_url\": \"https://storage.googleapis.com/.../analyzed_video.mp4\"\n} ```\n### Обработка ошибок\n- **400 Bad Request**: Некорректные параметры (например, отсутствующий или неверный UID администратора).\n- **401 Unauthorized**: Токен отсутствует или недействителен.\n- **403 Forbidden**: У пользователя нет необходимых прав или плана.\n- **404 Not Found**: Данные сессии или ресурсы не найдены.\n- **500 Internal Server Error**: Непредвиденная ошибка на сервере.\n### Безопасность\nВ заголовке `Authorization` должен быть указан действительный API-KEY токен.\n","parameters":[{"schema":{"type":"string"},"name":"session_id","in":"path","description":"ID сессии, для которой нужно получить или создать анализированное видео.","required":true},{"schema":{"type":"boolean"},"name":"is_jump","in":"query","description":"Указывает, является ли эта сессия для анализа прыжка.","required":false},{"schema":{"type":"boolean"},"name":"is_weight","in":"query","description":"Указывает, является ли эта сессия для анализа тяжелой атлетики.","required":false},{"schema":{"type":"boolean"},"name":"download","in":"query","description":"Если true, возвращает подписанный URL, который заставляет скачать видео.","required":false}],"responses":{"200":{"description":"URL анализированного видео успешно получен.","content":{"application/json":{"schema":{"type":"object","properties":{"analyzed_video_url":{"description":"URL анализированного видео.","type":"string","format":"uri"}}}}}},"400":{"description":"Bad Request - Возможно, некорректные параметры.","content":{"application/json":{"schema":{"description":"Схема ошибки для некорректных запросов (например, неверный UID)","type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Unauthorized - Токен недействителен или отсутствует.","content":{"application/json":{"schema":{"description":"Схема ошибки для отсутствующего или недействительного токена","type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"Forbidden - У пользователя нет прав или плана.","content":{"application/json":{"schema":{"description":"Схема ошибки для запрещенного доступа","type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Not Found - Данные сессии или ресурс не найдены.","content":{"application/json":{"schema":{"description":"Схема ошибки для отсутствующей сессии или ресурса","type":"object","properties":{"error":{"type":"string"}}}}}},"500":{"description":"Internal Server Error - Ошибка на сервере.","content":{"application/json":{"schema":{"description":"Схема ошибки для непредвиденных сбоев сервера","type":"object","properties":{"error":{"type":"string"}}}}}}},"tags":["session-management"]}}}}
````

## Загрузить/сгенерировать анализированное видео

> Загружает или генерирует анализированное видео для конкретной сессии, возвращая его URL.\
> \### Параметр пути\
> \- \*\*session\_id\*\* \*(строка, обязательно)\*: Уникальный идентификатор сессии.\
> \### Тело запроса (JSON)\
> \`\`\`json {\
> &#x20; "is\_jump": true,\
> &#x20; "is\_weight": false\
> } \`\`\`\
> \- \*\*is\_jump\*\* \*(логический, опционально)\*: Если true, обрабатывать как сессию прыжка.\
> \- \*\*is\_weight\*\* \*(логический, опционально)\*: Если true, обрабатывать как сессию тяжелой атлетики.\
> \### Структура ответа (HTTP 200)\
> При успехе возвращает JSON-объект с \`analyzed\_video\_url\`:\
> \`\`\`json {\
> &#x20; "analyzed\_video\_url": "<https://storage.googleapis.com/.../analyzed\\_video.mp4"\\>
> } \`\`\`\
> \### Обработка ошибок\
> \- \*\*400 Bad Request\*\*: Некорректные параметры или сессия уже анализирована.\
> \- \*\*401 Unauthorized\*\*: Токен отсутствует или недействителен.\
> \- \*\*403 Forbidden\*\*: У пользователя нет действительного плана.\
> \- \*\*404 Not Found\*\*: Данные сессии не найдены.\
> \- \*\*500 Internal Server Error\*\*: Непредвиденная ошибка на сервере.\
> \### Безопасность\
> В заголовке \`Authorization\` должен быть указан действительный API-KEY токен.<br>

````json
{"openapi":"3.1.1","info":{"title":"AIKYNETIX WEB API","version":"v2"},"servers":[{"url":"https://api.aikynetix.app"}],"security":[{"Bearer":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header","description":"Укажите ваш Bearer-токен (Firebase auth) в формате: Bearer <токен>"},"ApiKeyAuth":{"type":"apiKey","name":"API-KEY","in":"header","description":"Укажите ваш API-ключ в заголовке: API-KEY: <api_key>"}}},"paths":{"/session-management/sessions/{session_id}/analyzed-video/":{"post":{"operationId":"session-management_sessions_analyzed-video_create","summary":"Загрузить/сгенерировать анализированное видео","description":"Загружает или генерирует анализированное видео для конкретной сессии, возвращая его URL.\n### Параметр пути\n- **session_id** *(строка, обязательно)*: Уникальный идентификатор сессии.\n### Тело запроса (JSON)\n```json {\n  \"is_jump\": true,\n  \"is_weight\": false\n} ```\n- **is_jump** *(логический, опционально)*: Если true, обрабатывать как сессию прыжка.\n- **is_weight** *(логический, опционально)*: Если true, обрабатывать как сессию тяжелой атлетики.\n### Структура ответа (HTTP 200)\nПри успехе возвращает JSON-объект с `analyzed_video_url`:\n```json {\n  \"analyzed_video_url\": \"https://storage.googleapis.com/.../analyzed_video.mp4\"\n} ```\n### Обработка ошибок\n- **400 Bad Request**: Некорректные параметры или сессия уже анализирована.\n- **401 Unauthorized**: Токен отсутствует или недействителен.\n- **403 Forbidden**: У пользователя нет действительного плана.\n- **404 Not Found**: Данные сессии не найдены.\n- **500 Internal Server Error**: Непредвиденная ошибка на сервере.\n### Безопасность\nВ заголовке `Authorization` должен быть указан действительный API-KEY токен.\n","parameters":[{"schema":{"type":"string"},"name":"session_id","in":"path","description":"ID сессии, для которой нужно загрузить/сгенерировать анализированное видео.","required":true}],"responses":{"200":{"description":"URL анализированного видео успешно сгенерирован или обновлен.","content":{"application/json":{"schema":{"type":"object","properties":{"analyzed_video_url":{"description":"URL нового или обновленного анализированного видео.","type":"string","format":"uri"}}}}}},"400":{"description":"Bad Request - Возможно, некорректные данные сессии или видео уже анализировано.\n","content":{"application/json":{"schema":{"description":"Схема ошибки для некорректных запросов или уже анализированного видео","type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Unauthorized - Токен отсутствует или недействителен.","content":{"application/json":{"schema":{"description":"Схема ошибки для отсутствующего или недействительного токена","type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"Forbidden - У пользователя нет действительного платежного плана.","content":{"application/json":{"schema":{"description":"Схема ошибки для недостаточных прав плана","type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Not Found - Сессия не найдена или создание не удалось.","content":{"application/json":{"schema":{"description":"Схема ошибки для отсутствующих данных сессии или ресурса","type":"object","properties":{"error":{"type":"string"}}}}}},"500":{"description":"Internal Server Error - Ошибка на сервере.","content":{"application/json":{"schema":{"description":"Схема ошибки для непредвиденных сбоев сервера","type":"object","properties":{"error":{"type":"string"}}}}}}},"tags":["session-management"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"is_jump":{"description":"Является ли эта сессия связанной с прыжками.","type":"boolean"},"is_weight":{"description":"Является ли эта сессия связанной с тяжелой атлетикой.","type":"boolean"}}}}},"required":true}}}}}
````


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aikynetix.app/ru/api-documentation/developer-resources-and-api-reference/api-reference/analyzed-video.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
