---
title: "Статус задачи генерации видео"
method: GET
path: "/v1/videos/{id}"
tags: ["Videos"]
---

# Статус задачи генерации видео

`GET /v1/videos/{id}`

## Request

- Base URL: `https://api.hubris.pw`
- URL: `https://api.hubris.pw/v1/videos/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.hubris.pw/oauth/authorize`, token URL `https://api.hubris.pw/oauth/token`, scopes: `videos:read`)

Статус: `pending`, `in_progress`, `completed` или `failed`. При `completed` — `unsigned_urls` (адрес скачивания, нужен тот же ключ или токен) и `usage.cost`, итоговое списание в копейках; пока задача в работе — `usage.estimated_cost`, удержанная сумма.

Статус у провайдера запрашивается не чаще раза в 5 секунд на задачу, опрашивать чаще смысла нет. Подходит и ключ только для чтения.

## Path parameters

- `id` string, uuid, required: Номер задачи из ответа `POST /v1/videos`.

## Response `200`

Задача.

- VideoJob
  - `id` string, uuid, required
  - `status` 'pending' | 'in_progress' | 'completed' | 'failed', required
  - `created` integer, required: Время создания задачи, Unix-секунды.
  - `unsigned_urls` string[]: Только при `completed`: адрес скачивания `GET /v1/videos/{id}/content?index=0`. Несмотря на имя, нужен тот же ключ.
  - `usage` object
    - `cost` integer: При `completed`: итоговое списание, копейки.
    - `estimated_cost` integer: Пока задача в работе: сумма, удержанная под задачу, копейки (верхняя оценка; если сверка прошла раньше готовности — уже списанная). После готовности приходит `cost`, разница возвращается на баланс.
  - `error` string: Только при `failed`: нейтральный текст. Удержание возвращается целиком.

## Other responses

- `401`: Ключ не передан, невалиден, отозван или заморожен (`invalid_api_key`, `key_frozen_spike`).
- `403`: OAuth-токен без права `videos:read` (`insufficient_scope`). Ещё причины: management-ключ (`inference_key_required`), запрос не с адреса, к которому привязан ключ (`key_ip_not_allowed`), или заблокированный аккаунт (`account_blocked`).
- `404`: Задачи нет или она принадлежит другому аккаунту (`not_found`).

---

[API](https://skmtc.dev/hubris/apis/hubris-api.md) · [All operations](https://skmtc.dev/hubris/apis/hubris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hubris/apis/hubris-api/revisions/79ea91ed8f10?raw)