账户

这个密钥可以做什么

GET/api/me

您的密钥功能一览：启用的功能、允许的格式/分辨率/比例/视图/颜色/品牌、限制以及交付信息（CDN 主机 + 签名 URL 有效期）

access 显示该密钥使用的 API — v1 标准图像，v2 附加功能，all 两者 — 以及 queue_priority 其新图像的优先级 (high、normal、low).

API v2 插件： 使用插件，响应会添加 addon：格式、组、每个插件选项及其值、品牌、是否设置了车牌标志 (plate_logo) 以及您的密钥是否可在车牌上写入自己的文字 (plate_text)。

请求

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

200 · 关键功能。

{
  "access": "all",
  "queue_priority": "normal",
  "addon": {
    "formats": [
      "png",
      "webp",
      "jpeg",
      "avif"
    ],
    "groups": [
      "hero",
      "steered",
      "extra",
      "drone",
      "360",
      "lifestyle"
    ],
    "options": {
      "lights": [
        "on",
        "off"
      ],
      "windows": [
        "see_through",
        "dark"
      ],
      "plate": [
        "none",
        "blank",
        "logo",
        "text"
      ],
      "size": {
        "2k": 2560,
        "1080p": 1920,
        "720p": 1280,
        "540p": 960,
        "360p": 640,
        "thumb": 320
      }
    },
    "brands": [
      "*"
    ],
    "plate_logo": true,
    "plate_text": true
  },
  "features": {
    "shadow": true,
    "transparency": true,
    "mirroring": true,
    "grounding": true,
    "getall": true,
    "debug": false,
    "fallbacks": true,
    "watermark_forced": false
  },
  "allowed": {
    "formats": [
      "*"
    ],
    "resolutions": [
      "*"
    ],
    "ratios": [
      "*"
    ],
    "views": [
      "*"
    ],
    "colors": [
      "*"
    ],
    "brands": [
      "*"
    ]
  },
  "restrictions": {
    "blocked_brands": [],
    "year_range": null,
    "test_mode": false
  },
  "delivery": {
    "cdn": "cdn.vehicleimagery.com",
    "signed_url_ttl_seconds": 604800
  }
}

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."
}