# Скачивание сгенерированного медиафайла (анонимно)

**API:** Model API

**Endpoint:** `GET /api/v1/media/{file_id}`

Отдаёт потоком сгенерированный видеофайл (или изображение). Этот эндпоинт анонимный: аутентификацией служит HMAC-подпись в URL. Всегда используйте полный URL, возвращённый в массиве outputs задачи; не формируйте exp/sig самостоятельно. Поддерживает Range-запросы для возобновления загрузки. Медиафайл удаляется или становится недействительным, когда истекает срок действия подписи или TTL upstream.

## Base URL

- `https://openapi.felo.ai` — Боевая среда

## Authentication

No authentication required — this endpoint is anonymous.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `file_id` | path | yes | string, (uuid) | Подписанный ID файла из URL вывода задачи. |
| `exp` | query | yes | integer, (int64) | Срок действия подписи (в секундах Unix) из URL вывода. |
| `sig` | query | yes | string | HMAC-подпись из URL вывода. |

## Responses

### 200 — Медиафайл

**application/octet-stream**

Schema: string, (binary)

```json
{
  "type": "string",
  "format": "binary"
}
```

**video/mp4**

Schema: string, (binary)

```json
{
  "type": "string",
  "format": "binary"
}
```

### 400 — Некорректный запрос (например, произвольный ?url= не допускается)

**application/json**

Schema: `GenerationError` (`#/components/schemas/GenerationError`)

### 403 — Недействительная или истёкшая подпись

**application/json**

Schema: `GenerationError` (`#/components/schemas/GenerationError`)

### 404 — Неизвестный медиафайл

**application/json**

Schema: `GenerationError` (`#/components/schemas/GenerationError`)

### 410 — Срок действия медиафайла истёк, или upstream больше недоступен

**application/json**

Schema: `GenerationError` (`#/components/schemas/GenerationError`)

### 429 — Превышен лимит запросов для этого файла

**application/json**

Schema: `GenerationError` (`#/components/schemas/GenerationError`)

### 502 — Не удалось получить медиафайл от upstream

**application/json**

Schema: `GenerationError` (`#/components/schemas/GenerationError`)

## Schema definitions

### GenerationError

`#/components/schemas/GenerationError`

```json
{
  "type": "object",
  "description": "Конверт ошибок, совместимый с OpenAI.",
  "properties": {
    "error": {
      "type": "object",
      "required": [
        "message",
        "type"
      ],
      "properties": {
        "message": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "enum": [
            "invalid_request_error",
            "server_error"
          ]
        },
        "param": {
          "type": "string",
          "nullable": true
        },
        "code": {
          "type": "string"
        }
      }
    }
  }
}
```
