下載生成的媒體檔案(匿名)
串流傳輸生成的影片(或圖片)檔案。此端點為匿名:身分驗證即為 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