Views & sizes
Camera angles with yaw, size presets, formats and the 15 colors.
Camera views
Six fixed camera positions, described by their yaw around the vehicle (0° is straight ahead of the nose, increasing clockwise). The framing is identical for every vehicle in the catalog, which is what makes listings and comparison grids line up.
| view= | Label | Yaw | Description | Aliases |
|---|---|---|---|---|
front | Front | 0° | Straight-on front view | — |
front-3-4 | Front three-quarter | 35° | Front and driver's side at ~35°; the classic hero angle | front34, hero |
side | Side (facing left) | 90° | Perfect side profile, nose pointing left | side-left, profile |
side-right | Side (facing right) | 270° | Perfect side profile, nose pointing right | side-r |
rear | Rear | 180° | Straight-on rear view | back |
rear-3-4 | Rear three-quarter | 145° | Rear and driver's side at ~35° | rear34 |
Sizes
Source renders are square 1024×1024 PNGs. Ask for a named preset with size=, or exact pixels with w= and h= (1–1024). Resizing fits the square inside the box you give, so w=600&h=400 yields a 400×400 image. Upscaling beyond 1024 px is not offered — ask for the largest size and scale in your layout.
| size= | Pixels | Typical use |
|---|---|---|
thumb | 256 × 256 | Lists, autocomplete rows, chat avatars |
small | 512 × 512 | Cards and grids |
medium | 768 × 768 | Detail panes, comparison tables |
large | 1024 × 1024 | Hero images, print-quality exports |
https://carimage.dev/api/v1/images/car?make=tesla&model=model-3&year=2023&view=front&size=thumb
https://carimage.dev/api/v1/images/car?make=tesla&model=model-3&year=2023&view=front&w=600
https://carimage.dev/api/v1/images/car?make=tesla&model=model-3&year=2023&view=front&w=600&h=400Formats
format= accepts png, webp, jpg. PNG (default) and WebP keep the transparent background; JPG cannot, so it is composited onto a flat background. WebP is typically 3–5× smaller than PNG at the same size — prefer it for the web.
Colors
Paint is limited to 15 presets because every distinct color mints a new cached variant. The default is silver. Free-text colors ("navy", "midnight") are mapped onto the presets by the resolve endpoint and the MCP tools.
white#f4f4f2black#141414gray#7a7d82- default
silver#c3c6cb blue#1f4fa3red#b3151bgreen#1f6b3abrown#5c3d2ebeige#d9c9a8tan#c9a66borange#e0641byellow#f2c318gold#b8963eburgundy#6b1a2bpurple#5b2a86