Images & Media
imageUrl vs. effectiveImageUrl
Same canonical/effective pattern as title and description (see Feed API):
imageUrl— always the original source-provider image URL, ornullif the source had none. Never changes meaning.effectiveImageUrl/imageMode— what you should actually render.
imageMode
| Value | Meaning |
|---|---|
"source" |
effectiveImageUrl is the source-provider image. |
"generated" |
effectiveImageUrl is a FeedCentral-generated image. |
"none" |
There is genuinely no image for this article — not a fetch failure, a real absence. |
A "generated" image is served from FeedCentral's own public media endpoint:
GET /media/generated/{key}
This endpoint requires no authentication — it serves immutable, content-addressed public bytes, the same trust level as any other image URL already embedded in a published page. There is no listing/enumeration capability; you can only fetch a key you already have from a feed item.
What this page doesn't cover
Internal storage paths, generation pipeline details, and dedup mechanics are implementation
detail, not part of the public contract — none of it affects how you consume
effectiveImageUrl/imageMode.