Documentation

API reference

Read reference image content

GET/v1/image-assets/{asset_id}/content

Requires a Bearer key. Saved reference images return 307 with a redirect to a short-lived signed URL. Unavailable historical reference images return 410 asset_expired.

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

  • asset_idstringRequired

    ID of an ia_ image asset uploaded with the same key.

Responses and errors

HTTP 307

Redirects to a short-lived signed URL, with no JSON.

No response body.

Response header Location
{"schema":{"type":"string"}}

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 410

The reference image has expired or been deleted (asset_expired).

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