Fragen, beantwortet

Sie macht aus einer Fahrzeugbeschreibung ein Studiobild in Fotoqualität. Sie schicken Marke, Modell, Jahr, Variante und Ausstattung, oder eine FIN oder ein Kennzeichen, und bekommen eine signierte Bild-URL zurück, die Sie direkt in ein img-Tag setzen können. Kein Fotoshooting, keine Bilddatenbank, kein Retuscheschritt.

Ein API-Schlüssel im x-api-key-Header, sonst nichts. Der gesamte Katalog ist ein URL-Pfad, Sie können ihn also mit curl erkunden, bevor Sie eine Zeile Code schreiben. Die Dokumentation beginnt mit einer funktionierenden Anfrage.

GET /api/search?q=vw+golf gleicht freien Text gegen jede Marke und jedes Modell ab und verzeiht Spitznamen, Tippfehler und ungewöhnliche Leerzeichen. Zurück kommen Katalogpfade, die Sie weiter ablaufen können. Eine Jahreszahl in der Anfrage trifft nicht, Jahre liegen eine Ebene tiefer.

Ja. Die Beispielseite ist ein lebendiger Demo-Marktplatz: jedes Bild dort wird beim Stöbern aus der API geladen, und Sie können selbst die Ansicht wechseln, das Auto umlackieren und den Hintergrund ändern. Wenn Sie das an Ihren eigenen Fahrzeugen sehen wollen, schicken Sie uns ein paar, und wir kommen mit den Bildern zurück, meist noch am selben Arbeitstag.

Es gibt ein Paket auf npm und einen MCP-Server für KI-Agenten. Keines davon ist Pflicht. Es ist ein HTTPS-Endpunkt, der eine Bild-URL zurückgibt, und damit kommt jede Plattform schon zurecht.

Die meisten Teams haben noch am Tag der Schlüsselvergabe ein Bild auf einer Seite, weil die Anbindung eine URL ist. Von dort in den Produktivbetrieb ist meist eine Frage, wo Sie zwischenspeichern, nicht wie viel Code Sie schreiben.

100 Marken und mehr als 65.000 Modelle, aktuelle und frühere Modelljahre. GET /api/brands liefert jederzeit die aktuelle Liste für Ihren Schlüssel, Sie müssen also keiner Zahl auf einer Marketingseite glauben. Zur Abdeckungsseite.

Frühere Generationen sind abgedeckt, und das zählt mehr, als man denkt: Gebrauchtinserate, Remarketing-Kataloge und Kaufberater drehen sich überwiegend um Autos, die vor Jahren aus den Showrooms verschwunden sind. GET /api/{brand}/{model} listet jedes verfügbare Modelljahr zu diesem Modell.

Nein. Transporter, Nutzfahrzeuge, Pick-ups und Motorräder werden im gleichen Studiolook gerendert, eine gemischte Fuhrparkseite liest sich also weiterhin als ein Katalog. Genau deshalb steht auf der Beispielseite ein Motorrad im Raster.

Die API sagt es, statt zu raten, Sie bekommen also eine Verzweigung in Ihrem Code statt eines falschen Autos auf einer Seite. Wo ein angefragtes Modelljahr nicht existiert, rastet sie auf die nächstgelegene Generation ein und meldet das in errornotes.

Laufend, sobald Herstellerdaten verfügbar sind. Für Leasing und Konfiguratoren ist das der entscheidende Punkt: ein Modell steht meist Monate im Katalog, bevor das erste gebaut wird, und genau dann braucht die Angebotsseite es.

Ja, GET /api/getall gibt jede für Ihren Schlüssel verfügbare Konfiguration in einer Antwort aus. Sie ist bewusst groß und für einen nächtlichen Abgleich gedacht, nicht für einen Seitenaufruf. Zum Endpunkt.

Ja, Schlüssel lassen sich einschränken, und GET /api/me meldet alle Beschränkungen unter blocked_brands und year_range. Praktisch, wenn ein Händlervertrag nur einen Teil des Marktes abdeckt.

Neun Ansichten: acht Außenperspektiven (Front, Heck, beide Seiten und die vier Dreiviertelansichten) plus Innenaufnahmen wie die Mittelkonsole, sofern das Fahrzeug sie hat. Jede ist eine eigene Anfrage auf derselben Konfiguration, in identischem Studio-Bildausschnitt. Alle ansehen.

Ja, und die Änderung lackiert die echte Studioaufnahme um, ein Metallic liest sich also weiterhin als Metallic. Fünf Hausfarben liegen auf jedem Fahrzeug, die Katalogfarben der jeweiligen Marke kommen obendrauf, und 3M-Folierungen gibt es ebenfalls. GET /api/{...}/colors listet, was ein bestimmtes Auto bietet. Zu den Farben.

Vier Optionen, jede ein einzelner Parameter: shadow=true für einen Studio-Schlagschatten, ground=true für einen Kontaktschatten, damit das Auto auf einer Fläche steht, mirroring=true für einen spiegelnden Showroom-Boden und transparency=true für eine saubere Freistellung, die Sie überall platzieren können. Sehen Sie den Unterschied.

PNG, WebP, JPEG und AVIF, in Breiten von 200, 400, 800, 1200, 1600 oder 2000 Pixeln, mit Qualität zwischen 40 und 100 (standardmäßig 82). Es gibt außerdem benannte Vorgaben von thumb (320 px) bis full (2000 px), falls Sie lieber keine Zahlen wählen.

Von Haus aus 3:2. Fragen Sie ein anderes Seitenverhältnis an, wird das Bild gefüllt statt beschnitten, es wird also nie etwas vom Auto abgeschnitten: 1:1, 4:3, 16:9, 16:10, 2:1, 21:9 und die Hochformate stehen alle bereit. Deshalb können eine quadratische Rasterkachel und ein Breitbild-Banner dasselbe Fahrzeug nutzen, ohne dass jemand gestalterisch dazwischenmuss.

Ja, transparency=true liefert eine Freistellung mit echtem Alphakanal. Wissenswert: Transparenz erzwingt PNG, und ein PNG ist um ein Vielfaches schwerer als dasselbe Auto als WebP. Setzen Sie es dort ein, wo Sie den Alphakanal wirklich brauchen, und sonst überall WebP.

In einem regulären Tarif nicht. GET /api/me sagt Ihnen genau, was Ihr Schlüssel erlaubt, einschließlich ob ein Wasserzeichen erzwungen wird.

Genau darum geht es beim Rendern statt Sammeln. Jedes Fahrzeug nutzt dieselbe Kameraposition, denselben Abstand und dasselbe Licht, eine gemischte Tabelle vergleicht also Autos statt Fotografen. Das ist der Grund, warum Fuhrpark- und Leasingteams hier landen.

Er ist ein Pfad: /api/{brand}/{model}/{year}/{variant}/{trim}/{view}. Ein GET auf jedes kürzere Teilstück listet die nächste Ebene auf, der ganze Baum ist also durch Ablaufen auffindbar. Kein Schema, das man vor der ersten Anfrage lernen müsste.

Ja. Eine FIN funktioniert überall, die Kennzeichenabfrage hängt vom Markt ab. Marke, Modell, Jahr und Ausstattung lösen ebenfalls auf, und mehr steht in einem Inseratsformular oder einer Dienstwagenmeldung oft gar nicht. Mehr zur Auflösung.

Jede Konfiguration hat eine dauerhafte ID. GET /api/id/{id} liefert alle verfügbaren Ansichten, GET /api/id/{id}/{view} eine einzelne. IDs überstehen Katalogaktualisierungen und Umbenennungen, Sie können sie also gefahrlos in Ihre eigene Datenbank schreiben.

Ja, und die meisten Anbindungen tun das. Kopieren Sie das Bild in Ihren eigenen Speicher und liefern Sie es von dort aus, dann hängt ein Seitenaufruf nie an einem Aufruf bei uns. Signierte URLs bleiben sieben Tage gültig, das reicht reichlich zum Abholen und Ablegen.

Sie fällt auf den nächstgelegenen gültigen Wert zurück und sagt Ihnen in errornotes, was sie getan hat, statt abzubrechen. Es gibt 17 Codes, jeder mit einer klar formulierten Bedeutung, sodass Sie sie bewusst protokollieren oder ignorieren können. Zu den Codes.

Meist deutlich weniger, als es aussieht. Identische Konfigurationen lösen auf denselben Render auf, vierzig gleiche ausgeflottete Transporter sind also ein wiederverwendetes Bild. Speichern Sie auf Ihrer Seite zwischen, dann kostet ein Bildschirm, der jedem Besucher dieselben zwanzig Fahrzeuge zeigt, insgesamt zwanzig Anfragen und nicht zwanzig pro Besucher.

Es ist eine ganz normale HTTPS-URL, Ihr vorhandener Bildlader und sein Plattencache kommen also unverändert damit zurecht, nativ wie im Webview. Fragen Sie die Breite an, die das Layout tatsächlich nutzt, statt ein Druckbild auf dem Gerät herunterzurechnen. Mehr für App-Teams.

Nein, und das mit Absicht: der Katalog wird abgerufen, nicht zugestellt. Gleichen Sie ihn ab, wann Sie wollen, mit GET /api/getall, oder lesen Sie den Changelog für das, was erschienen ist. Auf Ihrer Seite muss nichts einen Endpunkt bereitstellen.

Sie kommen aus einem globalen Edge-Cache, das erste Byte stammt also von einem Ort in der Nähe des Besuchers und nicht von einem Ursprungsserver. Eine Variante wird einmal erzeugt und danach aus dem Cache ausgeliefert.

Ja. Die Statusseite zeigt Live-Verfügbarkeit und Antwortzeiten, gemessen außerhalb unserer eigenen Infrastruktur. GET /api/status ist eine maschinenlesbare Erreichbarkeitsprüfung für Ihre eigene Überwachung.

Zwischengespeicherte Varianten erreichen die API gar nicht, und das ist der Normalfall auf einer Katalogseite, auf der jeder Besucher dieselben Fahrzeuge sieht. Deshalb verhält sich ein Launch- oder Kampagnentag genauso wie ein Dienstag.

Nichts, wenn Sie dem üblichen Muster gefolgt sind: das Bild einmal in Ihren eigenen Speicher kopieren und von dort ausliefern. Ihre Seite hängt dann an Ihrem CDN, nicht an unserem. Das ist das Nützlichste, was Sie früh bauen können.

Sie werden aus Fahrzeugdaten gerendert, die wir lizenzieren. Es sind keine Fotos, und sie sind nicht von Händlerseiten oder aus Pressemappen zusammengesucht. Deshalb können wir die erlaubten Verwendungen schriftlich festhalten, und genau das ist meist die Frage, mit der ein Gespräch mit der Rechtsabteilung beginnt.

Ja. Inserate, Apps, Kampagnen, Druck und Kundendokumente sind abgedeckt, ohne Bildnachweis und ohne Wasserzeichen. Sagen Sie uns, welche Dokumente Sie erstellen, dann steht das ausdrücklich in der Lizenz.

Ja, und für Versicherer und Finanzierer ist genau das der Punkt: Angebote, Policenübersichten, Verträge und Schadenkorrespondenz. Wie das üblicherweise aufgesetzt wird, steht unter Versicherung und Finanzierung.

Nein. Es ist niemand im Bild und kein Ort zu sehen, das nimmt eine ganze Kategorie an Rechteklärung weg, die Fotografie mit sich bringt.

Fahrzeugkennungen, sonst nichts. Eine FIN kann ohne die Police, den Auftrag oder den Kunden übermittelt werden, zu dem sie gehört, es muss also nichts Personenbezogenes Ihre Systeme verlassen.

Es zeigt Modell, Ausstattung und die hinterlegte Werksfarbe, und genau so wurden Herstellerbilder immer schon verwendet. Es ist kein Foto eines bestimmten Exemplars und sollte auch nicht als solches ausgezeichnet werden. Die meisten Plattformen zeigen es als repräsentatives Bild dieser Konfiguration und behalten echte Fotos für die Galerie.

Die Anzeige gegenüber Ihren Nutzern ist standardmäßig abgedeckt. Nutzern den Download oder die Weitergabe zu erlauben, ist ein anderes Recht. Sagen Sie uns Bescheid, wenn Sie das brauchen, dann steht es ausdrücklich in der Lizenz statt im Ungefähren.

Nach unterschiedlichen Konfigurationen, nicht nach Seitenaufrufen. Deshalb flacht die Kostenkurve genau dort ab, wo das Volumen liegt: ein Modell, das Sie tausendmal listen, sind keine tausend Renders. Zu den Tarifen.

Ein grober Modellmix und wie viele Fahrzeuge Sie pro Monat listen oder ausliefern. Mehr braucht es nicht. Bei einem Vermieter ist das die Klassenliste, bei einem Finanzierer der Derivatemix, bei einem Portal die monatliche Anzahl der Inserate.

Nein. Ein Vermittler mit einer Handvoll Angebote pro Woche und ein Portal mit Millionen Inseraten bekommen dieselben Bilder und dieselben Optionen.

GET /api/me beantwortet das in einem Aufruf: freigeschaltete Funktionen, erlaubte Formate, Auflösungen, Seitenverhältnisse, Ansichten, Farben und Marken, dazu alle Einschränkungen und die Gültigkeitsdauer signierter URLs. Zum Endpunkt.

Nein. Eine Konfiguration wird einmal gerendert, jede spätere Anfrage nach derselben Kombination kommt aus dem Cache. Deshalb zahlt ein Portal, das dasselbe Modell tausendmal listet, nicht tausendmal.

Schreiben Sie uns oder buchen Sie ein kurzes Gespräch. Antworten kommen meist noch am selben Arbeitstag, und zwar von den Leuten, die das hier bauen, nicht aus einer Ticket-Warteschlange.

Schicken Sie uns Marke, Modell und Jahr. Ein Modell aufzunehmen ist für uns normale Arbeit und kein Gefallen, und es ist oft der schnellste Weg herauszufinden, ob eine Lücke ein Datenproblem oder eine Namensabweichung ist.

Fragen Sie nach. Eine bestimmte Ansicht, eine Hintergrundvariante oder ein Lieferformat, das nicht in der Liste steht, ist ein Gespräch wert. Manches, was heute Standard ist, fing damit an, dass ein Kunde danach gefragt hat.