Documentation

API reference

Query persistent image capabilities

GET/v1/image-models

The catalog currently supports Ark Seedream Pro/Lite and Qwen; unmerged Venice persistent workspace fixes are outside this baseline. Returns feature switches and capabilities executable with the same key; the catalog is not a production availability promise.

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

Responses and errors

HTTP 200

Persistent image capabilities queried successfully

application/json

Type
object
Required fields
workspace_enabledfile_storage_enableddataupload_enabled
  • workspace_enabledbooleanRequired

    Whether new tasks are enabled in the current workspace; does not mean historical objects were deleted.

  • file_storage_enabledbooleanRequired

    Whether the service enables managed file storage.

  • dataarrayRequired

    Array of data for the current page/catalog.

    data child fields (1)
    • []objectOptional
      [] child fields (8)
      • idstringRequired

        Public identifier of this object, used for its corresponding detail path.

      • namestringRequired

        Human-readable name.

      • providerstringRequired

        Model provider name shown in the capability catalog.

      • max_referencesintegerRequired

        Maximum reference images allowed by the selected model.

      • max_nintegerRequired

        Maximum output images allowed by the selected model.

      • sizesarrayRequired

        List of sizes allowed by this model.

        sizes child fields (1)
        • []objectOptional
          [] child fields (2)
          • valuestringRequired

            Size value actually submitted.

          • labelstringRequired

            Display name of the size.

      • versionstringRequired

        Contract/capability or tool version; runs use the tool version returned by the catalog.

      • outputstringRequired

        Tool output JSON or model output form, defined by the corresponding schema/capability.

  • upload_enabledbooleanRequired

    Whether the service enables reference image uploads.

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