Images

These types are used to configure and work with images returned by the TMDB API. All image URLs are composed of a base URL, a size, and a file path.

`ImagesConfig`

Top-level image configuration passed to the constructor via the images option.

Property	Type	Default	Description
`secure_images_url`	`boolean`	`true`	When `true`, uses the HTTPS base URL. Set to `false` only if HTTPS is unavailable in your environment.
`default_image_sizes`	`Partial<DefaultImageSizesConfig>`	—	Default sizes for each image category. Applied automatically when no size is specified at call time.

Defines per-category default sizes. All properties are optional.

Property	Type	Description
`posters`	`PosterSize`	Default size for movie and TV show poster images.
`backdrops`	`BackdropSize`	Default size for backdrop/banner images.
`logos`	`LogoSize`	Default size for network, studio, and show logos.
`profiles`	`ProfileSize`	Default size for cast and crew profile photos.
`still`	`StillSize`	Default size for TV episode still images.

A convenience type that groups all image size types under a single object. Useful when you need to reference size types generically.

Property	Type	Description
`BackdropSize`	`BackdropSize`	Size options for backdrop images.
`LogoSize`	`LogoSize`	Size options for logo images.
`PosterSize`	`PosterSize`	Size options for poster images.
`ProfileSize`	`ProfileSize`	Size options for profile images.
`StillSize`	`StillSize`	Size options for still images.
`ImageSize`	`ImageSize`	Union of all available image sizes.

Used for movie and TV show backdrop (banner/hero) images.

type BackdropSize = "w300" | "w780" | "w1280" | "original";

Used for production company, network, and streaming service logos.

type LogoSize = "w45" | "w92" | "w154" | "w185" | "w300" | "w500" | "original";

Used for movie and TV show poster images.

type PosterSize = "w92" | "w154" | "w185" | "w342" | "w500" | "w780" | "original";

Used for cast and crew profile/headshot images.

type ProfileSize = "w45" | "w185" | "h632" | "original";

Note: h632 is height-constrained rather than width-constrained, unlike the other sizes.

Used for TV episode still/screenshot images.

type StillSize = "w92" | "w185" | "w300" | "original";

A union of all available size values across every image type. Use this when you need to accept any valid size regardless of category.

type ImageSize = BackdropSize | LogoSize | PosterSize | ProfileSize | StillSize;

Constant	Value
`IMAGE_BASE_URL`	`http://image.tmdb.org/t/p/`
`IMAGE_SECURE_BASE_URL`	`https://image.tmdb.org/t/p/`

Image URLs are assembled as {base_url}{size}{file_path}, for example:

https://image.tmdb.org/t/p/w500/abc123.jpg