API v2 オプション
スタジオグループ：その画像をリストアップ
GET/api/{brand}/{model}/{year}/{variant}/{trim}/hero
API v2アドオン — v2アクセスのキー。 スタジオグループの画像。hero は車の任意のスタジオグループを表します。車がどのグループを持っているかは、トリムエンドポイントの groups にあります。
| グループ | 表示内容 | 画像名（例の車） |
|---|---|---|
hero | ヒーローショット：三分の二のビュー、地面から撮影されたものもあります | front_left, front_left_ground, front_right, front_right_ground, left_ground, rear_left, rear_right, right_ground (8) |
steered | 前輪を回転させた3つのカメラの高さから | front_left, front_left_eye, front_left_high, front_left_low, front_right, … (8) |
extra | さまざまな角度: 3つのカメラの高さからすべての側面と角を、さらに30°と45°の角度からも。 | front_eye, front_high, front_low, front_left_30, front_left_30_eye, front_left_45_high, rear_right_45_low, left_eye … (56) |
drone | 上から：角度のあるショット、急な視点、そして真上から | front_left, front_right, front_steep, rear_left, rear_right, rear_steep, top (7) |
画像名は、側面（front、front_left、left、rear_right …）と接尾辞から構成されます：_eye = 目線の高さ、_high = カメラが上、_low = カメラが低い、_ground = 地面の高さ、_30 / _45 = 30° / 45°の角度からのコーナービュー、_steep = 上からの急な角度、top = 真上から。各車の正確なリストは、このエンドポイントのviewsに常に記載されています。
views から画像を選び、*スタジオグループ画像を解決する* で解決します、例えば GET /api/Audi/Q9/2026/SUV/Default/hero/front_left。
パスパラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
brand 必須 | string | ブランド名（オプション車のカタログ名の更新） |
model 必須 | string | モデル名。 |
year 必須 | 整数 | モデル年（4桁）。正確な年が欠落している場合、最も近い利用可能な世代が使用されます（エラーノート `Y01`） |
variant 必須 | string | ボディバリアント。 |
trim 必須 | string | トリムレベル |
クエリパラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
version | string | 1つのバージョンからの結果のみ：`v1` = 標準画像、`v2` = API v2 の追加（標準画像にフォールバックしない）。このパラメータがない場合は、キーが許可するすべてのものが取得されます。キーで許可されていない場合 → `403`。v1v2 |
