Documentation

API reference

Get a short-lived file download URL

GET/v1/files/{file_id}/download-url

Historical files for the same account and key. Valid keys with exhausted quota are allowed; revoked/expired keys are still rejected. Downloads require ready; deletion while referenced returns 409. retry only retries saving the original result, not generation. Ordinary APIs use day-based retention, persistent tasks protect references, and expires_at=0 means no fixed expiration.

Playback and downloads

Read the file status before requesting a short-lived download URL. Getting a URL cannot make a file available before storage is ready. Send the original API key only to GloopAPI; do not attach it when downloading from the returned HTTPS address.

Persistent videos use short-lived object storage URLs to support native Range playback. The full GET on the ordinary video content path is a different transport from this player flow. Obtain another URL when a link expires; refreshing a link cannot recover an expired or deleted file.

Authentication and permissions

Use your current GloopAPI key. Available models, capabilities and permissions depend on its catalog and the endpoint documentation.

Authorization: Bearer $GLOOP_API_KEY

Authentication schemes: BearerAuth

Request

Path parameters

  • file_idstringRequired

    Public ID of a managed file belonging to the same key.

Responses and errors

HTTP 200

Short-lived file download URL retrieved successfully

application/json

Type
object
Required fields
urlexpires_at
  • urlstringRequired

    Short-lived signed download URL; do not disclose or retain it long-term.

    Format
    "uri"
  • expires_atintegerRequired

    Unix seconds.

HTTP 400

Invalid request fields or parameters.

application/json

Type
object
Required fields
error

HTTP 401

The key is missing, invalid, expired, or revoked.

application/json

Type
object
Required fields
error

HTTP 403

Insufficient IP, account, model, or tool permissions.

application/json

Type
object
Required fields
error

HTTP 404

Object/capability unavailable, or feature switch disabled.

application/json

Type
object
Required fields
error

HTTP 409

Idempotency/quote conflict, object not ready, or still referenced.

application/json

Type
object
Required fields
error

HTTP 429

Request/queue rate limit.

application/json

Type
object
Required fields
error

HTTP 500

Internal authentication or data storage failure.

application/json

Type
object
Required fields
error

HTTP 503

Service, pricing, or storage unavailable.

application/json

Type
object
Required fields
error