Conta

O que esta chave pode fazer

GET/api/me

As capacidades de sua chave em uma chamada: recursos habilitados, formatos/resoluções/relacionamentos/vistas/cores/marcas permitidos, restrições e informações de entrega (host do CDN + TTL da URL assinada).

access indica qual API a chave utiliza — v1 imagens padrão, v2 complementar, all ambos — e queue_priority sua prioridade para novas imagens (high, normal, low).

Adicional da API v2: com o adicional a resposta adiciona addon: formatos, grupos, cada opção de adicional com seus valores, marcas e se um logotipo de placa está configurado (plate_logo).

Solicitar

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

200 · Capacidades principais.

{
  "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"
      ],
      "size": {
        "2k": 2560,
        "1080p": 1920,
        "720p": 1280,
        "540p": 960,
        "360p": 640,
        "thumb": 320
      }
    },
    "brands": [
      "*"
    ],
    "plate_logo": 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` ausente ou inválida.

{
  "error": "Invalid API key"
}

403 · Restrição de plano (recurso, formato ou marca não permitido) ou solicitação bloqueada.

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

404 · Nenhum dado para o caminho solicitado.

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