Car Image API
Documentation

Make logos

GET /api/v1/images/logo — make logos, 1 credit each; trademark terms.

Request a logo for a make in the vehicle catalog. The first request generates it from a make-specific prompt; later requests use the cached logo. Each delivered logo costs one credit, from the credits a plan includes every month (or the signup credits); credits are not sold.

Get a make logo

GET/api/v1/images/logo
images:read1 credit
bash
curl "https://carimage.dev/api/v1/images/logo?make=toyota&w=256&h=256&trim=1&padding=5" \
  -H "Authorization: Bearer $CAR_IMAGE_API_KEY" --output toyota-logo.png

make is required: a catalog make name or slug, such as Toyota or mercedes-benz. Find makes with GET /api/v1/vehicles?year=2024, which lists the makes sold in that model year (Vehicles & search). Unknown makes return 404.

Use the same image transforms: size(thumb 256, small 512, medium 768, large 1024), w and h (also spelled width and height; above 1024 clamped, see X-Clamped-Parameters), fit=contain|cover|inside, background=transparent|<CSS color name>|hex, trim=1, padding (0–50, with trim), and format=png|webp|jpg|auto. PNG and transparent background are the defaults; JPG defaults to white. Auto negotiates WebP or PNG from Accept.

The response contains image bytes and the X-Credits-Charged, X-Credits-Remaining, X-Image-Source, X-Image-Width, X-Image-Height, ETag and X-Request-Id headers. Delivery is private, no-store. Each successful request costs one credit; failed delivery is refunded. This endpoint does not offer signed URLs or conditional 304 responses.

Logos do not count as vehicle images in your plan. When the balance is short, the request answers 402 with "code": "subscription_required_for_credits". Cold generation uses the same account and service capacity limits as car images. No model, year, view, paint color or custom prompt is read: any other parameter, a prompt or a color included, is a free 400 that names it and lists the names a logo reads, because a logo drawn without it would be billed as a different picture. Only tracking tags and cache busters (utm_source, v…) are ignored, and named in X-Ignored-Parameters. The image's other names work here too: brand for make, bg for background. Generated artwork may be inaccurate: check it before use.

CLI and MCP

bash
car-image logo --make Toyota --width 256 --trim --out toyota-logo.png

Call get_make_logo with make and the same transform options for an inline MCP image. Both core and all toolsets include it. Each successful call costs one credit, including cache hits; format: auto returns PNG inline. To use a logo on a website, download and host the file; signed logo URLs are not available.

TypeScript SDK

typescript
const logo = await client.getMakeLogo({ make: "toyota", width: 256, trim: true });
await writeFile("toyota-logo.png", logo.bytes);