Appearance
视频下载
下载生成的视频文件
当视频生成任务完成后,你可以通过下载接口获取视频文件。
下载视频文件
使用视频 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