Skip to content

视频下载 ​

下载生成的视频文件

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

下载视频文件 ​

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

bash
curl -L "https://aiapi.fhddos.com/v1/videos/$VIDEO_ID/content" \
  -H "Authorization: Bearer $TOKEN" \
  --output "$VIDEO_ID.mp4"

INFO

注意使用 -L 参数以支持重定向,视频文件可能托管在 CDN 上。

路径参数 ​

  • video_id:视频任务的唯一标识符

响应 ​

  • 成功(200):返回 MP4 格式的视频文件流
  • 未找到(404):视频任务不存在或尚未完成

注意事项 ​

  • 下载不消耗额外配额,可以多次下载同一视频
  • 建议在下载后保存到本地存储,避免依赖临时链接
  • 时长与分辨率应跟随创建任务时所使用的官方契约;如需了解经济型分组与平台路由说明,请参考 Sora 视频路由与分组。

WARNING

视频文件过期时间较短,请在任务完成后及时下载。视频 URL 可能包含临时访问令牌,请勿公开分享。

OpenAPI ​

yaml
openapi: 3.0.0
info:
  title: Gemini Veo Video API
  description: Gemini Veo 视频生成 API(OpenAI 风格)
  version: 1.0.0
servers:
  - url: https://aiapi.fhddos.com
    description: Fhddos 生产环境
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

Fhddos AI 用户文档