# 생성된 미디어 파일 다운로드(익명)

**API:** Model API

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

생성된 영상(또는 이미지) 파일을 스트리밍합니다. 이 엔드포인트는 익명이며, URL의 HMAC 서명이 인증 역할을 합니다. 작업의 outputs 배열에서 반환된 전체 URL을 항상 사용하고 exp/sig를 직접 구성하지 마세요. 재개를 위한 Range 요청을 지원합니다. 서명 또는 업스트림 TTL이 만료되면 미디어가 제거되거나 무효화됩니다.

## 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) | 작업 출력 URL의 서명된 파일 ID입니다. |
| `exp` | query | yes | integer, (int64) | 출력 URL의 서명 만료 시각(유닉스 초)입니다. |
| `sig` | query | yes | string | 출력 URL의 HMAC 서명입니다. |

## 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 — 미디어가 만료되었거나 업스트림에서 더 이상 사용할 수 없습니다

**application/json**

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

### 429 — 이 파일에 대한 속도 제한에 걸렸습니다

**application/json**

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

### 502 — 업스트림 미디어 가져오기 실패

**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"
        }
      }
    }
  }
}
```
