问题，已解答

它把一段车辆描述变成照片级的影棚图片。您发送品牌、车型、年份、版本和配置，或者一个 VIN 或车牌，就能拿回一个签名图片地址，可以直接放进 img 标签。不用拍摄，不用图库，不用修图。

只需在 x-api-key 请求头里放一个 API 密钥，别无其他。整个目录就是一条 URL 路径，所以在写下第一行代码之前就能用 curl 探索。文档从一个可运行的请求开始。

GET /api/search?q=vw+golf 用自由文本匹配所有品牌和车型，并能容忍别称、拼写错误和奇怪的空格。返回的是可继续往下走的目录路径。在查询里写年份不会匹配，年份在下一层。

可以。示例页面就是一个实时的演示市场：您浏览时，每张图片都从 API 取回，您可以自己切换视角、给车重新喷漆、更换背景。想在自己的车上看效果，就发几辆给我们，我们会带着图片回来，通常在同一个工作日。

npm 上有一个软件包，也有面向 AI 智能体的 MCP 服务器。两者都不是必需的。它就是一个返回图片地址的 HTTPS 端点，任何平台早就会处理。

大多数团队在拿到密钥的当天就能让页面上出现一张图，因为集成就是一个地址。从那里走到生产环境，通常是「在哪里缓存」的问题，而不是「要写多少代码」。

100 个品牌、超过 65,000 款车型，涵盖当前和以往年款。GET /api/brands 随时返回您密钥对应的实时清单，您不必去相信营销页面上的数字。查看覆盖范围。

以往车代同样有覆盖，而这比人们以为的更重要：二手挂牌、二手车目录和购车指南谈的大多是多年前就已停售的车。GET /api/{brand}/{model} 会列出该车型所有可用的年款。

不是。厢式车、商用车、皮卡和摩托车都以同样的影棚风格渲染，所以混合车队页面读起来仍然像一个目录。正因如此，示例页面的网格里放了一辆摩托车。

API 会直接告诉您，而不是靠猜，所以您得到的是代码里的一个分支，而不是页面上的一辆错车。请求的年款不存在时，它会落到最接近的可用车代，并在 errornotes 里说明。

持续更新，只要厂商数据可用就会加入。对租赁和配置器来说这一点尤其关键：一款车型通常在第一台下线前几个月就已在目录里，而那正是报价页面需要它的时候。

可以，GET /api/getall 会在一次响应里导出您密钥可访问的全部配置。它体积很大是刻意为之，用于夜间同步，而不是页面加载。查看该端点。

可以，密钥的权限范围可以限制，GET /api/me 会在 blocked_brands 和 year_range 里报告所有限制。当经销协议只覆盖部分市场时很有用。

九个视角：八个外观角度（车头、车尾、两侧和四个四分之三角度），以及车辆配备时的内饰镜头，比如中控台。每个都是同一配置下的独立请求，采用一致的影棚取景。全部查看。

可以，而且改色会重新喷涂真正的影棚照片，所以金属漆看起来依然是金属漆。每辆车都可用五种自有配色，各品牌自己的目录色叠加其上，还有 3M 车衣。GET /api/{...}/colors 会列出某辆具体车型提供的选项。查看配色。

四个选项，每个都只是一个参数：shadow=true 生成影棚投影，ground=true 生成接触阴影让车落在地面上，mirroring=true 生成反射式展厅地面，transparency=true 生成可以放到任何地方的干净抠像。看看区别。

PNG、WebP、JPEG 和 AVIF，宽度可选 200、400、800、1200、1600 或 2000 像素，质量在 40 到 100 之间（默认 82）。如果不想自己挑数字，也有从 thumb（320 px）到 full（2000 px）的命名预设。

原生 3:2。请求其他比例时，图片会补边而不是裁切，所以车身永远不会被切掉：1:1、4:3、16:9、16:10、2:1、21:9 以及对应的竖版全部可用。因此一张方形卡片和一条宽屏横幅可以使用同一辆车，中间不需要设计师。

可以，transparency=true 会返回带真实 alpha 通道的抠像。值得注意：透明会强制使用 PNG，而 PNG 的体积是同一辆车 WebP 版本的数倍。在真正需要 alpha 的地方使用它，其余场合用 WebP。

常规方案下不会。GET /api/me 会明确告诉您密钥允许什么，包括是否强制加水印。

这正是渲染而非拍摄的意义。每辆车使用相同的机位、距离和光线，所以一张混排表格比较的是车，而不是摄影师。这也是车队和租赁团队最终会走到这里的原因。

它是一条路径：/api/{brand}/{model}/{year}/{variant}/{trim}/{view}。对任何更短的前缀发起 GET，都会列出下一层，因此整棵树可以靠遍历发现。第一次请求之前，没有需要先学的结构。

可以。VIN 在各地都能用；车牌查询取决于市场。品牌、车型、年份和配置同样能解析，而挂牌表单或公务车申报往往也就只有这些内容。了解更多解析方式。

每个配置都有一个永久 id。GET /api/id/{id} 返回全部可用视角，GET /api/id/{id}/{view} 返回其中一个。id 不会因目录更新或改名而失效，可以放心写进您自己的数据库。

可以，而且大多数集成都会这么做。把图片复制到自己的存储里并从那里分发，这样页面加载就永远不依赖对我们的调用。签名地址有效期七天，足够取回并保存。

它会回退到最接近的有效值，并在 errornotes 里告诉您它做了什么，而不是直接失败。共有 17 个代码，每个都有一句大白话的含义，您可以有意识地记录或忽略它们。查看代码。

通常远比看上去少。相同的配置会归到同一次渲染，所以四十辆同款退役厢式车只是一张被复用的图片。在您这边做好缓存，一个向每位访客展示同样二十辆车的页面，总共只花二十次请求，而不是每位访客二十次。

它就是一个普通的 HTTPS 地址，您现有的图片加载器和磁盘缓存无需改动即可处理，原生和 WebView 都一样。请按版式实际使用的宽度请求，而不是在设备上把印刷级图片缩小。更多面向应用团队的内容。

没有，而且是有意为之：目录是拉取式的。您可以随时用 GET /api/getall 同步，或者读更新日志了解发布了什么。您这边不需要提供任何端点。

它们从全球边缘缓存分发，所以第一个字节来自离访客更近的节点，而不是源站。一个变体只生成一次，之后都从缓存返回。

可以。状态页面展示实时可用率和响应时间，测量点位于我们自己的基础设施之外。GET /api/status 是可供您自己监控使用的机器可读存活检查。

缓存过的变体根本不会到达 API，而这正是目录页的常态，因为每位访客看到的是同样的车辆。所以上线日或活动日的表现，和平常的周二没有区别。

不会有事，只要您按常规做法：把图片复制到自己的存储里一次，然后从那里分发。您的页面从此依赖自己的 CDN，而不是我们的。这是最值得尽早搭好的一件事。

它们由我们取得授权的车辆数据渲染而来。它们不是照片，也不是从经销商网站或新闻资料包里抓来的。正因如此，我们才能把允许的用途写进合同，而这通常正是法务部门开场就会问的问题。

可以。挂牌、应用、营销活动、印刷和客户文件都在覆盖范围内，无需署名，也没有水印。告诉我们您会制作哪些文件，它就会明确写进授权。

可以，而且对保险公司和贷款方来说这通常正是重点：报价单、保单明细、合同和理赔往来文件。具体通常怎么落地，见保险和金融。

不需要。画面里没有人，也没有可辨识的地点，这就省掉了摄影必然带来的一整类授权工作。

只需要车辆标识，别无其他。VIN 可以在不带保单、订单或所属客户的情况下发送，因此与个人有关的信息不必离开您的系统。

它展示的是登记在案的车型、配置和原厂颜色，厂商图片一直就是这么用的。它不是某一台具体车辆的照片，也不应被标注成照片。大多数平台把它作为该配置的代表图，把真实照片留给相册。

向您的用户展示这些图片默认已经包含在内。允许用户下载或再分发文件是另一项权利，需要的话请告诉我们，它会明确写进授权，而不是含糊带过。

按不同配置计费，而不是按页面浏览量，所以成本曲线恰好在量最大的地方变平：一款车型上架一千次，并不等于一千次渲染。查看方案。

一份大致的车型构成，以及您每月上架或服务多少辆车。这就够了。对租赁公司是车型等级清单，对贷款方是衍生车型构成，对门户是每月挂牌数量。

不会。每周只做几份方案的经纪商，和拥有数百万条挂牌的门户，拿到的是同样的图片和同样的选项。

GET /api/me 一次调用就能回答：已启用的功能、允许的格式、分辨率、比例、视角、颜色和品牌，以及任何限制和签名链接的有效期。查看该端点。

不会。一个配置只渲染一次；之后同样组合的每次请求都从缓存返回。所以一个把同款车型挂了一千次的门户，并不会付一千次的钱。

给我们写信或预约一次简短通话。回复通常在同一个工作日送达，而且来自真正在做这件事的人，不是工单队列。

把品牌、车型和年份发给我们。添加一款车型对我们是日常工作，不是帮忙，而且这往往是最快弄清缺口究竟是数据问题还是命名不一致的办法。

问就好。清单上没有的特定视角、背景处理或交付格式，都值得聊一聊；今天的一些标准功能，最初就是某位客户提出来的。