Gallery

List your generations

Lists everything you have created - images, videos, audio and text - newest first. Each completed file-backed item includes a file.download_url you can fetch with the same Bearer token. Text generations (captions, transcripts, etc.) include a text field.

Items are filtered to the containers your token can read. A token holding no readable container gets an empty list with a 200, never a 403: the route gate already ran and this is a view filter, not an access denial.

BREAKING CHANGES that landed on this response - see x-breaking-changes: item.uuid is now the FILE uuid (the generation uuid moved to generation_uuid), and item.category now reports the plural container vocabulary (images|videos|audio|text|files) where it used to report image|video|text|other.

get/v1/gallery

Request

  • Base URL: https://contentmaschine.ai/api
  • URL: https://contentmaschine.ai/api/v1/gallery
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://contentmaschine.ai/api/oauth/authorize, token URL https://contentmaschine.ai/api/oauth/token)

Query parameters

category'all' | 'images' | 'videos' | 'audio' | 'text' | 'files' | 'image' | 'video'

Filter by scope container. This is the SAME vocabulary every item's category and container field reports, so a value read out of a payload can be filtered on. DEPRECATED and accepted for one more release: the singular image and video; a request using either is answered with a Deprecation: true response header. Anything else is a 400 whose message lists the valid values.

status'completed'

Only completed is accepted; omit for all. generating and failed are 400s, not empty pages.

limitinteger
offsetinteger

Response

A page of gallery items

successboolean

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.