llms.txt
+11 −9
− > The car image API by Meter. Studio-quality, transparent-background renders of any vehicle in the open @meterapp/vehicle-db catalog (1,608 makes, 42,333 models, 1990–2027) in 9 views (front, rear, both profiles, all four three-quarter corners and top, straight down from above), any paint color (15 named presets or any hex), PNG/WebP/JPG (or `auto`) up to 1024px, any w×h box (fit contain|cover|inside), transparent or solid background, optional trim (or a `framing` preset: consistent, tight, bala− - [OpenAPI 3.1 (v2.35.1)](https://carimage.dev/openapi.json): machine-readable schema with x-agent-notes and x-pricing.− - [Car images by make and model](https://carimage.dev/cars?ref=llms): the whole catalog, 1,608 makes and 42,333 models. Every make (`/cars/<make>`), model (`/cars/<make>/<model>`) and model year (`/cars/<make>/<model>/<year>`) has a page under the slugs the API reads, with its model years, the request that renders it and the renders already made. Link a person to one to show them a vehicle, for example the [2024 Porsche 911](https://carimage.dev/cars/porsche/911/2024?ref=llms).− - Remote MCP (Streamable HTTP): https://carimage.dev/api/mcp — `Authorization: Bearer cimg_...`, or OAuth 2.1 + PKCE for chat clients that cannot hold a key (add the same URL as a custom connector; discovery at https://carimage.dev/.well-known/oauth-protected-resource/api/mcp). Twelve core tools by default, enough to look a vehicle up, render it and watch the month's allowance (resolve_vehicle, search_vehicles, decode_vin, check_vehicles, get_car_image, create_car_image_urls, get_account, reques− - CLI: `npx @meterapp/car-image` (login, get, url, resolve, vin, 3d create|get|download|list, whoami, mcp). `get` and `url` take --vehicle veh_…, --color #1a2b3c, --fit, --background, --framing, --trim, --padding, --shadow and --format auto; `url` takes --idempotency-key; `vin <VIN> [--year] [--json]` decodes for free; `3d create --make --model --year [--color] [--vehicle] [--webhook-url] [--webhook-secret] [--publish] [--wait] [--out <dir>]`, `3d get <id> [--wait]`, `3d download <id> [--format − - Sizing: one of `w`/`h` scales the square 1024 px source (never upscaled); both together make a box placed by `fit`: `contain` (default) exactly w×h with transparent padding, `cover` exactly w×h center-cropped, `inside` may return less. `trim=1` crops to the car's bounds first (`padding` 0–50 % margin, only with trim); `framing=tight` (= `trim=1`) and `framing=balanced` (= `trim=1&padding=6`) are presets for them, and `framing=consistent` (the default) keeps the camera scale every view of a veh− - Plans (https://carimage.dev/pricing?ref=llms): Free $0 (100 vehicle images a month, 100 credits once at signup, evaluation and personal projects, 120 requests/min per key); Pro $49/month or $490/year (2,500 vehicle images and 1,000 credits a month, commercial use while subscribed, 120 requests/min per key); Business $99/month or $990/year (10,000 vehicle images and 4,000 credits a month, 600 requests/min per key, 25 keys); Enterprise custom (negotiated volume, a bulk export or catalog copy by − - On 402 stop and tell the human: code plan_image_limit means the month's vehicle images are used up (used, included, requested, resets_at; images already received keep serving); subscription_required_for_credits means a 3D model, logo or upgrade needs more credits than the account holds, and credits are not sold; plan_vehicle_limit applies only to accounts on the credit meter. Every 402 carries checkout_url (the next plan), pack_url (Image Packs) and pricing: hand the human the link with the pr− MCP `get_image_availability`: free prepared/cached status, quality (standard, enhanced, premium or null), upgrade state and render estimates. Resolve the vehicle first; pass its id, optional view (omit for all nine) and color. Prepared means cached and quick to serve from storage. It renders, queues and counts nothing.+ > The car image API by Meter. Studio-quality, transparent-background renders of any vehicle in the open @meterapp/vehicle-db catalog (1,608 makes, 42,349 models, 1990–2027) in 9 views (front, rear, both profiles, all four three-quarter corners and top, straight down from above), any paint color (15 named presets or any hex), PNG/WebP/JPG (or `auto`) up to 2560 px (1024 px for renders from before 2026-11), any w×h box (fit contain|cover|inside), transparent or solid background, optional trim (or + - [OpenAPI 3.1 (v2.39.0)](https://carimage.dev/openapi.json): machine-readable schema with x-agent-notes and x-pricing.+ - Endpoint reference: [Images](https://carimage.dev/docs/images?ref=llms) (GET /api/v1/images/car and every image parameter) · [Availability & quality](https://carimage.dev/docs/quality?ref=llms) · [Authentication](https://carimage.dev/docs/authentication?ref=llms) · [Rate limits](https://carimage.dev/docs/rate-limits?ref=llms) · [CLI](https://carimage.dev/docs/cli?ref=llms).+ - [Car images by make and model](https://carimage.dev/cars?ref=llms): the whole catalog, 1,608 makes and 42,349 models. Every make (`/cars/<make>`), model (`/cars/<make>/<model>`) and model year (`/cars/<make>/<model>/<year>`) has a page under the slugs the API reads, with its model years, the request that renders it and the renders already made. Link a person to one to show them a vehicle, for example the [2024 Porsche 911](https://carimage.dev/cars/porsche/911/2024?ref=llms).+ - Remote MCP (Streamable HTTP): https://carimage.dev/api/mcp — `Authorization: Bearer cimg_...`, or OAuth 2.1 + PKCE for chat clients that cannot hold a key (add the same URL as a custom connector; discovery at https://carimage.dev/.well-known/oauth-protected-resource/api/mcp). The hosted URL serves all forty-one tools. Use `?toolset=core` for the twelve core tools (resolve_vehicle, search_vehicles, decode_vin, check_vehicles, get_car_image, create_car_image_urls, get_account, request_feature, r+ - CLI: `npx @meterapp/car-image` (login, get, url, resolve, vin, 3d create|get|download|list, whoami, mcp). `get` and `url` take --vehicle veh_…, --color #1a2b3c, --fit, --background, --framing, --trim, --padding, --shadow and --format auto; `url` takes --idempotency-key; `vin <VIN> [--year] [--json]` decodes for free; `3d create --make --model --year [--color] [--vehicle] [--webhook-url] [--webhook-secret] [--publish] [--wait] [--out <dir>]`, `3d get <id> [--wait]`, `3d download <id> [--format + - Sizing: one of `w`/`h` scales the stored image (a 1024 px square for renders from before 2026-11, a canvas of up to 2560 px for new ones; never upscaled); `aspect_ratio` and `resolution` are presets for the box; both together make a box placed by `fit`: `contain` (default) exactly w×h with transparent padding, `cover` exactly w×h center-cropped, `inside` may return less. `trim=1` crops to the car's bounds first (`padding` 0–50 % margin; without trim it pads the stored frame); `framing=tight` (+ - Market: `market=AU` (an ISO 3166-1 alpha-2 country code, optional) names the market of sale, for model years that look different in different markets. Today every market gets the default appearance, and the answer says which was served (`X-Vehicle-Appearance`, `appearance` in JSON). An account can keep a default market; an explicit one always wins. It is never part of what an image is: the same vehicle, color and view is one image and one counted vehicle image under any market.+ - Plans (https://carimage.dev/pricing?ref=llms): Free $0 (30 vehicle images per account, not per month, plus 30 more as a one-time courtesy once they run out; 100 credits once at signup; evaluation and personal projects, 120 requests/min per key); Pro $49/month or $490/year (2,500 vehicle images and 1,000 credits a month, commercial use while subscribed, 120 requests/min per key); Business $99/month or $990/year (10,000 vehicle images and 4,000 credits a month, 600 requests/min per key, 25 keys)+ - On 402 stop and tell the human: code plan_image_limit means the month's vehicle images, or Free's per account, are used up (used, included, requested, resets_at, null on Free; images already received keep serving); subscription_required_for_credits means a 3D model, logo or upgrade needs more credits than the account holds, and credits are not sold; plan_vehicle_limit applies only to accounts on the credit meter. Every 402 carries checkout_url (the next plan), pack_url (Image Packs) and pricin+ MCP `get_image_availability`: free prepared/cached status, whether each view is verified, quality (standard, enhanced, premium or null), upgrade state and render estimates. Resolve the vehicle first; pass its id, optional view (omit for all nine) and color. Prepared means cached and quick to serve from storage. It renders, queues and counts nothing.