下载生成的媒体文件(匿名)
以流式传输生成的视频(或图像)文件。此端点支持匿名访问:URL 中的 HMAC 签名即认证凭据。请始终使用任务 outputs 数组中返回的完整 URL;不要自行构造 exp/sig。支持 Range 请求以便断点续传。签名或上游 TTL 过期后,媒体会被移除或失效。
路径参数
- 类型: string 格式: uuidfile
_id 必填任务输出 URL 中的带签名文件 ID。
查询参数
- 类型: integer 格式: int64exp必填
签名过期时间(Unix 秒),来自输出 URL。
- 类型: stringsig必填
HMAC 签名,来自输出 URL。
响应
- 类型: string 格式: binary200
媒体文件
- 类型: object · GenerationError400
请求无效(例如不允许任意 ?url= 参数)
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json - 类型: object · GenerationError403
签名无效或已过期
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json - 类型: object · GenerationError404
未知媒体文件
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json - 类型: object · GenerationError410
媒体已过期,或上游已不再提供
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json - 类型: object · GenerationError429
此文件的请求频率受限
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json - 类型: object · GenerationError502
上游媒体获取失败
兼容 OpenAI 的错误封装。
- 类型: objecterror
- message类型: string必填
- type类型: string 枚举必填值
- invalid
_request _error - server
_error
- code类型: string
- param类型: string 可为 null
application/json
Request Example for get/api/v1/media/{file_id}
curl 'https://openapi.felo.ai/api/v1/media/123e4567-e89b-12d3-a456-426614174000?exp=1&sig='
@filename