画像
署名付きの画像URLを解決します
GET/api/{brand}/{model}/{year}/{variant}/{trim}/{view}
コアエンドポイントです。メタデータと署名済みのimage_urlを返します。これは、直接<img>に埋め込みます。
クエリパラメータとして任意のオプションを追加します。車両に利用できないものやプランで許可されていないものは、最も近い有効な値にフォールバックし、errornotesに報告されます（失敗するのではなく）。
例
?format=webp&width=1200— WebP、幅1200ピクセル。?ratio=16:9&format=jpeg— 16:9にパディング。?mirroring=true— 反射するショールームの床に車が映る。?transparency=true&format=png— 透明背景に切り抜き。?color=wine_red— ワインレッドの家の色に塗り替え。?color=Racing%20Red&shadow=true— キアのカタログペイントにスタジオシャドウを追加。
パスパラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
brand 必須 | string | ブランド名または別名（大文字小文字を区別しない）。 |
model 必須 | string | モデル名。 |
year 必須 | 整数 | モデル年（4桁）。正確な年が欠落している場合、最も近い利用可能な世代が使用されます（エラーノート `Y01`） |
variant 必須 | string | ボディバリアント。 |
trim 必須 | string | トリムレベル |
view 必須 | string | ビュー名 — /api/views を参照してください（例：前面、前左、後面）。 |
クエリパラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
format | string | 提供形式。`auto` は WebP を選択。オリジナルは PNG。pngwebpjpegavifauto |
resolution | string | サイズ/品質のプリセット（明示的な幅/品質で上書き）。 defaultthumbsmallmediumlargefull |
ratio | string | アスペクト比にパディングします。 `default` = ネイティブ。 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | 整数 | 幅のラダーにスナップされたピクセル単位の明示的な幅 |
height | 整数 | ピクセル単位の明示的な高さ |
quality | 整数 | エンコーダー品質（40–100） |
color | string | 名前で塗装色を指定（大文字小文字を区別しない、スペースはURLエンコード、例：`Racing%20Red`）。車はオーダーメイドで塗り替えられます — 仕上げが真実で、反射やトリムが保たれます。車の `/colors` に表示されているセット（ハウスカラー + そのブランドのカラー）をリストします。`/api/colors` のどのアクティブカラーでもリクエスト可能です。不明な色 → デフォルトペイント + エラーノート `F04`。他のすべてのオプションと組み合わせ可能です。 |
shadow | string | スタジオの地面の影 — 配信時にレンダリングされ、すべての外観ビューで利用可能です。`mirroring=true`の場合、この機能は車体下の影を制御します。truefalse |
transparency | string | 透明な切り抜き背景 — 外観のすべてのビューで利用可能（PNG/WebPと併用）。 truefalse |
ground | string | 車を地面に停める（透明なバリアントが必要）。 true |
mirroring | string | 反射する床。`true` = シャドウ付きアンダーボディ、`clean` = 反射のみ。透明なバリアントが必要です。 trueclean |
