参考

所有交付选项捆绑

GET/api/options

一次调用即可获取所有可请求的内容，按计划过滤：格式、宽度、质量、比例、分辨率、color 选项及修饰标志（阴影/透明度/地面/镜像/水印），以及您的计划是否允许每一项。

请求

curl "https://api.vehicleimagery.com/api/options" \
  -H "x-api-key: YOUR_API_KEY"

200 · 套装选项。

{
  "formats": [
    "png",
    "webp",
    "jpeg",
    "avif"
  ],
  "widths": [
    200,
    400,
    800,
    1200,
    1600,
    2000
  ],
  "quality": {
    "min": 40,
    "max": 100,
    "default": 82
  },
  "modifiers": {
    "shadow": {
      "param": "shadow",
      "values": [
        "true",
        "false"
      ],
      "allowed": true
    },
    "mirroring": {
      "param": "mirroring",
      "values": [
        "true",
        "clean"
      ],
      "allowed": true,
      "note": "floor reflection; needs a transparent variant; shadow=false drops the underbody"
    }
  },
  "params": [
    "format",
    "resolution",
    "ratio",
    "width",
    "height",
    "quality",
    "color",
    "shadow",
    "transparency",
    "ground",
    "mirroring"
  ]
}

401 · 缺失或无效的 `x-api-key`。

{
  "error": "Invalid API key"
}

403 · 计划限制（功能、格式或品牌不允许）或被阻止的请求。

{
  "error": "Mirroring is not allowed by your plan."
}

404 · 请求路径无数据。

{
  "error": "Brand 'Xyz' not found — check /api/brands for valid brands."
}