> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hingnet.com.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 视频下载

> 下载生成的视频文件

当视频生成任务完成后，你可以通过下载接口获取视频文件。

## 下载视频文件

使用视频 ID 直接下载生成的视频：

```bash theme={null}
curl -L "https://models.hingnet.com.cn/v1/videos/$VIDEO_ID/content" \
  -H "Authorization: Bearer $TOKEN" \
  --output "$VIDEO_ID.mp4"
```

<Callout type="info">
  注意使用 `-L` 参数以支持重定向，视频文件可能托管在 CDN 上。
</Callout>

### 路径参数

* `video_id`：视频任务的唯一标识符

### 响应

* **成功（200）**：返回 MP4 格式的视频文件流
* **未找到（404）**：视频任务不存在或尚未完成

## 注意事项

* 下载不消耗额外配额，可以多次下载同一视频
* 建议在下载后保存到本地存储，避免依赖临时链接
* 时长与分辨率应跟随创建任务时所使用的官方契约；如需了解灰色渠道差异，请参考 [Sora 视频路由与分组](/guide/sora-video-routing)。

<Callout type="warning">
  视频文件过期时间较短，请在任务完成后及时下载。视频 URL 可能包含临时访问令牌，请勿公开分享。
</Callout>


## OpenAPI

````yaml GET /v1/videos/{video_id}/content
openapi: 3.0.0
info:
  title: Gemini Veo Video API
  description: Gemini Veo 视频生成 API（OpenAI 风格）
  version: 1.0.0
servers:
  - url: https://models.hingnet.com.cn
    description: HingNet 生产环境
security:
  - BearerAuth: []
paths:
  /v1/videos/{video_id}/content:
    get:
      tags:
        - Veo Videos
      summary: 下载视频
      description: 下载生成的视频文件
      operationId: downloadVeoVideo
      parameters:
        - name: video_id
          in: path
          required: true
          description: 视频任务 ID
          schema:
            type: string
          example: video_abc123
      responses:
        '200':
          description: 视频文件
          content:
            video/mp4:
              schema:
                type: string
                format: binary
        '400':
          description: 视频未就绪
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: 任务不存在
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            code:
              type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API Key

````