塗装色と仕上げ

どの車も異なる塗装色で提供できます。塗装色は実際のスタジオ撮影に適用されます — 反射、クローム、ガラス、エンブレム、そして内装はそのまま、塗装だけが変わります。その仕上げに忠実に（ソリッドペイントはソリッドのまま、メタリックペイントは光に依存するフロップを保ちます）。

色を見つける

全カタログ — /api/colors。 現在のすべての色と、その色が属するブランド:

{ "colors": [
  { "color_name": "default",    "color_make": "Vehicleimagery" },
  { "color_name": "wine_red",   "color_make": "Vehicleimagery" },
  { "color_name": "Racing Red", "color_make": "Kia" }
] }

1台ごと — /colors エンドポイント。 簡潔にまとめた色名: この車のブランドの色とハウスカラー:

GET /api/Kia/Avella/1994/Basis/base/colors
→ { …, "colors": ["default", "Racing Red", "black", "blue", "orange", "white", "wine_red"] }

ハウスカラー対ブランドカラー

• ハウスカラー (color_make: "Vehicleimagery"): white, silver, graphite, black, beige, brown, red, wine_red, orange, yellow, green, blue, dark_blue — カラーサポート付きのすべての車で利用可能なカレードメタリックライン、すべての車の/colorsにリストされています。
• ブランドカラー: オリジナルメーカーの塗料（例：Mercedes-Benz *Luganograu Metallic*）。そのブランドの車にリストされている — ただし、どのアクティブカタログカラーもどの車でもリクエスト可能です。

色のリクエスト

名前を ?color= として渡す（大文字小文字を区別しない；スペースはURLエンコード）：

GET /api/BMW/1/2004/Basis/base/front?color=wine_red
GET /api/BMW/1/2004/Basis/base/front?color=Racing%20Red

応答のsettings.colorは適用された色を反映し、image_urlは塗り替えられた車を提供します。

他のすべてと組み合わせます。

色は他のすべての配信オプションと組み合わせられます。

?color=wine_red&shadow=true                    # painted + studio shadow
?color=wine_red&transparency=true&format=png   # painted cut-out
?color=wine_red&format=webp&width=1200         # painted, WebP, 1200 px
?color=wine_red&mirroring=true                 # painted on the showroom floor

仕上げ（API v2アドオン）

オプションの画像では、すべてのカタログカラーが実際の塗装で描かれています:

ヘックスカラーはグロス仕上げです — 別の仕上げを得るには、前に仕上げを置きます:

?color=c8102e                    # gloss
?color=metallic_315fbf           # metallic, effect colour derived
?color=metallic_315fbf_5693f9    # metallic with your own effect colour
?color=matte_283b56              # matt_ works too
?color=satin_384a8c
?color=carbon_545454
?color=chrome_eac972

metallic, pearl および satin は効果色のオプションの2番目のヘックスを取ります。レスポンスは settings.paint としてフィニッシュを表示します — /api/options は addon.options.color.finishes の下にフィニッシュをリストします。

オプションのスタジオ画像では、白やその他の明るい塗料が明るく清潔に表示され、colorなしでも反射なしです — ライフスタイルシーンではシーンの光を保ちます。

フォールバック

色のリクエストは決して失敗しません：

• 不明な色名 → デフォルトの塗装、エラーノートF04
• プランで許可されていない色 → デフォルトの塗装、エラーノート C09。
• color=default (またはパラメータを省略) → 元の塗装。

色は外観ビューに適用されます。内装ビューは常にオリジナルの内装を表示します。

パフォーマンス

リカラーは最初のリクエストで生成され、その後CDNキャッシュから提供されます — 繰り返しリクエストは他のすべての変換と同じように即座に行われます。