Skip to content

generatedgallerybot/generated-media-protocol

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Generated Media Protocol

A tiny open JSONL format for AI-generated images, prompts, provenance, safety labels, and gallery packs.

It came out of Generated Gallery, a free AI art gallery and prompt index. The goal is simple: AI image collections should be portable. A crawler, gallery, agent, or researcher should be able to read the same records without being locked to one database or website.

Live references

Record shape

{
  "id": "civitai:123456",
  "url": "https://example.com/image.jpeg",
  "thumbnailUrl": "https://example.com/image.jpeg",
  "source": {
    "site": "civitai.com",
    "url": "https://civitai.com/images/123456",
    "externalId": "123456"
  },
  "media": {
    "type": "image",
    "width": 1024,
    "height": 1024,
    "mimeType": "image/jpeg"
  },
  "generation": {
    "prompt": "cinematic portrait of a cat trader",
    "model": "Flux",
    "seed": "12345"
  },
  "taxonomy": {
    "category": "portraits",
    "tags": ["portrait", "cinematic"]
  },
  "safety": {
    "nsfw": false,
    "rating": "sfw"
  },
  "indexedAt": "2026-05-06T00:00:00.000Z"
}

Why this exists

Most AI image galleries are silos. Prompts, model metadata, safety flags, and source attribution are usually trapped in app-specific databases.

This format is meant to be boring and useful:

  • one JSON object per generated media item
  • source URL and upstream ID preserved
  • prompt and generation metadata are first-class fields
  • safety labels are explicit
  • JSONL-friendly for large exports
  • compatible with static hosting, crawlers, and agents

What counts as a pack?

A pack is a small themed collection, usually 5 to 12 records, with a manifest and source links. Think moodboard, prompt notebook, model test set, or agent-readable image collection.

Good packs have:

  • one memorable theme
  • source URLs and provenance
  • prompt fragments where available
  • clear SFW/NSFW labels
  • enough metadata to rebuild or inspect the collection later

Live pack example

The current public example pack is Haunted Product Catalog, part of Machine Dream Finds. It shows how a small themed collection can keep image URLs, prompt fragments, source trails, safety labels, and a shareable gallery page together.

Useful dataset endpoints from Generated Gallery:

Status

v0.2.1, experimental but live. The schema in this repo mirrors the current Generated Gallery export.

Media rights stay with upstream creators/platforms. This protocol is for metadata, provenance, and discovery. It does not magically make source images free to reuse.

About

Open JSONL protocol for AI-generated images, prompts, provenance, safety labels, and gallery packs

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors