Felo API PlatformFelo API Platform
v0.3.0
OpenAPI 3.1.0

Download a generated media file (anonymous)

Felo API Support
MIT
Server:https://openapi.felo.ai
Client Libraries
Shell Curl

Download a generated media file (anonymous)

​

Streams the generated video (or image) file. This endpoint is anonymous: authentication is the HMAC signature in the URL. Always use the full URL returned in the task outputs array; do not construct exp/sig yourself. Supports Range requests for resume. Media is removed or invalidated when the signature or upstream TTL expires.

Path Parameters
  • file_id
    Type: string Format: uuid
    required

    Signed file id from a task output URL.

Query Parameters
  • exp
    Type: integer Format: int64
    required

    Signature expiry (unix seconds), from the output URL.

  • sig
    Type: string
    required

    HMAC signature, from the output URL.

Responses
  • 200
    Type: string Format: binary

    Media file

  • 400
    Type: object · GenerationError

    Invalid request (e.g. arbitrary ?url= is not allowed)

    OpenAI-compatible error envelope.

    • error
      Type: object
      • message
        Type: string
        required
      • type
        Type: string enum
        required
        values
        • invalid_request_error
        • server_error
      • code
        Type: string
      • param
        Type: string nullable
    application/json
  • 403
    Type: object · GenerationError

    Invalid or expired signature

    OpenAI-compatible error envelope.

    • error
      Type: object
      • message
        Type: string
        required
      • type
        Type: string enum
        required
        values
        • invalid_request_error
        • server_error
      • code
        Type: string
      • param
        Type: string nullable
    application/json
  • 404
    Type: object · GenerationError

    Unknown media file

    OpenAI-compatible error envelope.

    • error
      Type: object
      • message
        Type: string
        required
      • type
        Type: string enum
        required
        values
        • invalid_request_error
        • server_error
      • code
        Type: string
      • param
        Type: string nullable
    application/json
  • 410
    Type: object · GenerationError

    Media has expired or upstream no longer available

    OpenAI-compatible error envelope.

    • error
      Type: object
      • message
        Type: string
        required
      • type
        Type: string enum
        required
        values
        • invalid_request_error
        • server_error
      • code
        Type: string
      • param
        Type: string nullable
    application/json
  • 429
    Type: object · GenerationError

    Rate limited for this file

    OpenAI-compatible error envelope.

    • error
      Type: object
      • message
        Type: string
        required
      • type
        Type: string enum
        required
        values
        • invalid_request_error
        • server_error
      • code
        Type: string
      • param
        Type: string nullable
    application/json
  • 502
    Type: object · GenerationError

    Upstream media fetch failed

    OpenAI-compatible error envelope.

    • error
      Type: object
      • message
        Type: string
        required
      • type
        Type: string enum
        required
        values
        • invalid_request_error
        • server_error
      • code
        Type: string
      • param
        Type: string nullable
    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

Media file

Download a generated media file (anonymous)