Get a generation

One library item, when you already hold its id from List generations. The same rules apply as on a page: renderable media only, and the URLs are signed with a 7-day TTL, so re-fetch rather than storing one.

Request#

curl https://api2.rundiffusion.com/api/v2/library/$ITEM_ID \
  -H "Authorization: Bearer $RUNDIFFUSION_TOKEN"

const item = await fetch(
  `https://api2.rundiffusion.com/api/v2/library/${itemId}`,
  { headers: { Authorization: `Bearer ${process.env.RUNDIFFUSION_TOKEN}` } },
).then(r => r.json());

item = requests.get(
    f"{BASE}/library/{item_id}",
    headers=HEADERS,
).json()

Response#

200 OK with one item, in exactly the shape the Generation object the listing returns, so a client that parses pages parses this for free.

{
  "id": "Rn8qWm…:0b6a1f6e-93cf-…",
  "run_id": "Rn8qWm…",
  "result_id": "0b6a1f6e-93cf-…",
  "type": "IMAGE",
  "url": "https://storage.googleapis.com/…",
  "thumb_url": "https://storage.googleapis.com/…",
  "mime_type": "image/png",
  "width": 1024,
  "height": 1024,
  "duration_seconds": null,
  "size_bytes": 1284211,
  "created": "2026-08-01T09:14:00+00:00",
  "tool_id": "Tl9xBv…"
}

This fetch reads your own generations: on a team account it is pinned to yours, and reading other members' work is the listing's scope=all question, gated by the same permission there.

Errors#