Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

下载生成的媒体文件(匿名)

服务器:https://openapi.felo.ai
客户端库

下载生成的媒体文件(匿名)

​

以流式传输生成的视频(或图像)文件。此端点支持匿名访问:URL 中的 HMAC 签名即认证凭据。请始终使用任务 outputs 数组中返回的完整 URL;不要自行构造 exp/sig。支持 Range 请求以便断点续传。签名或上游 TTL 过期后,媒体会被移除或失效。

路径参数
  • file_id
    类型: string 格式: uuid
    必填

    任务输出 URL 中的带签名文件 ID。

查询参数
  • exp
    类型: integer 格式: int64
    必填

    签名过期时间(Unix 秒),来自输出 URL。

  • sig
    类型: string
    必填

    HMAC 签名,来自输出 URL。

响应
  • 200
    类型: string 格式: binary

    媒体文件

  • 400
    类型: object · GenerationError

    请求无效(例如不允许任意 ?url= 参数)

    兼容 OpenAI 的错误封装。

    • error
      类型: object
      • message
        类型: string
        必填
      • type
        类型: string 枚举
        必填
        值
        • invalid_request_error
        • server_error
      • code
        类型: string
      • param
        类型: string 可为 null
    application/json
  • 403
    类型: object · GenerationError

    签名无效或已过期

    兼容 OpenAI 的错误封装。

    • error
      类型: object
      • message
        类型: string
        必填
      • type
        类型: string 枚举
        必填
        值
        • invalid_request_error
        • server_error
      • code
        类型: string
      • param
        类型: string 可为 null
    application/json
  • 404
    类型: object · GenerationError

    未知媒体文件

    兼容 OpenAI 的错误封装。

    • error
      类型: object
      • message
        类型: string
        必填
      • type
        类型: string 枚举
        必填
        值
        • invalid_request_error
        • server_error
      • code
        类型: string
      • param
        类型: string 可为 null
    application/json
  • 410
    类型: object · GenerationError

    媒体已过期,或上游已不再提供

    兼容 OpenAI 的错误封装。

    • error
      类型: object
      • message
        类型: string
        必填
      • type
        类型: string 枚举
        必填
        值
        • invalid_request_error
        • server_error
      • code
        类型: string
      • param
        类型: string 可为 null
    application/json
  • 429
    类型: object · GenerationError

    此文件的请求频率受限

    兼容 OpenAI 的错误封装。

    • error
      类型: object
      • message
        类型: string
        必填
      • type
        类型: string 枚举
        必填
        值
        • invalid_request_error
        • server_error
      • code
        类型: string
      • param
        类型: string 可为 null
    application/json
  • 502
    类型: object · GenerationError

    上游媒体获取失败

    兼容 OpenAI 的错误封装。

    • error
      类型: object
      • 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
Download a generated media file (anonymous)

需要帮助?