API v2 オプション
スタジオグループ画像を解決する
GET/api/{brand}/{model}/{year}/{variant}/{trim}/{group}/{image}
API v2アドオン — v2アクセスのキー。 スタジオグループの1枚の画像: hero (ヒーローショット、一部は地面から)、steered (前輪を切った状態)、extra (3つのカメラの高さからのさらに多くの角度、角度は30°と45°)、drone (上空から)。グループとその画像名は *スタジオグループ: その画像をリストする* に説明されています。
GET …/{trim} は車のグループをリストアップします (groups)、GET …/{trim}/{group} は一つのグループの画像をリストアップします (views)。その後、ここで一つを解決します。すべての画像オプション、アドオンオプションを含む (lights、background、ヘックス color、windows、plate、fit、size、hotspots) を受け入れます。
例: GET /api/Audi/Q9/2026/SUV/Default/hero → { group: "hero", views: { front_left: true, front_left_ground: true, … } }, そして GET /api/Audi/Q9/2026/SUV/Default/hero/front_left?color=c8102e&size=1080p&format=webp。
パスパラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
brand 必須 | string | ブランド名（オプション車のカタログ名の更新） |
model 必須 | string | モデル名。 |
year 必須 | 整数 | モデル年（4桁）。正確な年が欠落している場合、最も近い利用可能な世代が使用されます（エラーノート `Y01`） |
variant 必須 | string | ボディバリアント。 |
trim 必須 | string | トリムレベル |
group 必須 | string | スタジオグループ：ヒーロー、ステアリング、エクストラ、ドローン（トリムエンドポイントの `groups` を参照） |
image 必須 | string | グループの画像（グループの `views` を参照） |
クエリパラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
format | string | 出力形式。 pngwebpjpegavifauto |
ratio | string | アスペクト比。 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | 整数 | ピクセル単位の幅 |
color | string | 塗装：カタログカラー名または6桁のヘックス。 |
shadow | string | スタジオの地面の影。truefalse |
lights | string | **API v2 アドオン：** ヘッドライトをオンまたはオフ (デフォルト `off`)。画像で利用不可 → `off` + エラーノート `L26`。onoff |
background | string | **API v2 アドオン：** `white` (デフォルト)、`transparent`、または `f4f4f4` のような 6 桁の 16 進数カラー。スタジオ画像のみ (ライフスタイル → エラーノート `B32`) |
windows | string | **API v2 アドオン：** `see_through` = 画像のガラス (デフォルト)、`dark` = 透けないプライバシーガラス。利用不可 → エラーノート `W28`。see_throughdark |
plate | string | **API v2 アドオン：** ナンバープレート — `none` = 画像のまま (デフォルト)、`blank` = 空のプレート、`logo` = プレートにあなたのロゴ (キーで設定; ない場合 → 空白 + エラーノート `N30`)。noneblanklogo |
fit | string | **API v2 アドオン：** 車が `ratio` / `size` ボックスをどのように埋めるか — `contain` はパディング (デフォルト)、`cover` はトリミング。ライフスタイル画像は常にカバー。containcover |
size | string | **API v2 アドオン：** 最も長い辺 — `2k` 2560 px、`1080p` 1920 px、`720p` 1280 px、`540p` 960 px、`360p` 640 px、`thumb` 320 px。`width` / `height` は `size` に優先します。2k1080p720p540p360pthumb |
hotspots | string | **API v2 アドオン：** `hotspots` をレスポンスに追加 — 画像の興味のあるポイント (リム、ヘッドライト …) を 0–1 の分数として。例えば、インタラクティブビューアー用。true |
