Перейти к навигации
BeatAPIVideo AnalysisWorkflow API

Анализ видео

Проанализируйте загруженный MP4 или MOV с обычным или углублённым мультимодальным рассуждением с учётом временных меток.

Если исходный файл локальный, загрузите его и используйте полученный data.url. Сохраните data.id, опрашивайте задачу и соблюдайте правила обработки ошибок и повторов.

Аутентификация

AuthorizationBearer

Передавайте API-ключ в виде Authorization: Bearer <BEATAPI_API_KEY>.

Заголовки

Idempotency-KeystringОпциональный

Необязательный ключ повторного запроса. Повторное использование того же ключа с тем же нормализованным запросом возвращает принятую задачу.

Запрос

This endpoint expects an object.
video_urlstringОбязательныйformat: "uri"

URL входного MP4 или MOV, размещённого в BeatAPI и полученного через POST /v1/files для текущего аккаунта. Максимальная подтверждённая длительность — 600 секунд.

promptstringОбязательный1-12000 characters

Инструкция для анализа. Запросите временные метки, если важна точность привязки ко времени.

analysis_depthenumОпциональныйПо умолчанию standard

Standard — недорогой маршрут по умолчанию; deep использует маршрут с более глубоким рассуждением.

Допустимые значения:
max_output_tokensintegerОпциональный256-8192По умолчанию 2048

Запрошенный лимит ответа. Выходные токены по данным поставщика могут включать скрытые токены рассуждений сверх этого значения; BeatAPI фиксирует разницу для аудита и оплачивает фактически заявленное использование в пределах резерва задачи.

Ответ

Анализ принят для асинхронной обработки.

dataobject

Принятое или текущее состояние задачи BeatAPI.

Ошибки

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error