Schnell integriert
Ein POST-Request mit Ihrem Foto — das bearbeitete Bild kommt in Sekunden zurück. Kein SDK nötig.
Authentifizierung per Schlüssel
Ein einzelnes Bearer-Token, das Ihrem Konto zugeordnet ist. Jederzeit im Dashboard neu generieren oder widerrufen.
Dieselben Modelle wie in der App
Genau die Kennzeichen-Erkennungs- und Unschärfemodelle, die CarFlow AI antreiben — produktionsreif, keine Demo.
Keine separate Abrechnung
API-Aufrufe werden von Ihrem bestehenden Guthaben abgebucht — genau wie in der App.
Dokumentation
Kennzeichen unkenntlich machen
Endpoint
POST
https://api.carflowai.com/v1/blur-platescurl -X POST https://api.carflowai.com/v1/blur-plates \-H "Authorization: Bearer sk_live_your_key" \-F "[email protected]" \-F "style=blur" \-o result.jpg
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
image | file | Yes | The car photo to process. |
style | string | No | blur (default), pixelate, white, or black. |
Response
| Status | Content-Type | Body |
|---|---|---|
| 200 | image/jpeg | The processed photo, as raw image bytes. |
| 4xx / 500 | application/json | { error, code } — see Error codes below. |
Kennzeichen durch eigenes Design ersetzen
Endpoint
POST
https://api.carflowai.com/v1/plate-logocurl -X POST https://api.carflowai.com/v1/plate-logo \-H "Authorization: Bearer sk_live_your_key" \-F "[email protected]" \-F "[email protected]" \-o result.jpg# Or reuse a design you already saved in your Assets library instead of# re-uploading it every call — pass its id, not a file:curl -X POST https://api.carflowai.com/v1/plate-logo \-H "Authorization: Bearer sk_live_your_key" \-F "[email protected]" \-F "logoAssetId=your-saved-asset-id" \-o result.jpg
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
image | file | Yes | The car photo to process. |
logoorlogoAssetId | file or string | Yes — exactly one of the two | The plate design. Either upload the file directly (logo), or reference one already saved in your Assets library by id (logoAssetId) to avoid re-uploading it every call. |
Response
| Status | Content-Type | Body |
|---|---|---|
| 200 | image/jpeg | The processed photo, as raw image bytes. |
| 4xx / 500 | application/json | { error, code } — see Error codes below. |
Schatten unter dem Auto hinzufügen
Endpoint
POST
https://api.carflowai.com/v1/car-shadowcurl -X POST https://api.carflowai.com/v1/car-shadow \-H "Authorization: Bearer sk_live_your_key" \-F "[email protected]" \-F "reflection=false" \-o result.png
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
image | file | Yes | The car photo. A transparent PNG cutout is used as is; any other photo is cut out first. |
reflection | boolean | No | true adds a floor reflection under the shadow (beta). Default false. |
Response
| Status | Content-Type | Body |
|---|---|---|
| 200 | image/png | The processed photo, as raw image bytes. |
| 4xx / 500 | application/json | { error, code } — see Error codes below. |
Cut out car
Coming soonEndpoint
POST
https://api.carflowai.com/v1/xxxxxxxxxxxcurl -X POST https://api.carflowai.com/v1/cutout \-H "Authorization: Bearer sk_live_your_key" \-F "[email protected]" \-o result.png
Logo on photo
Coming soonEndpoint
POST
https://api.carflowai.com/v1/xxxxxxxxxxxcurl -X POST https://api.carflowai.com/v1/logo-overlay \-H "Authorization: Bearer sk_live_your_key" \-F "[email protected]" \-F "logoAssetId=your-saved-asset-id" \-o result.jpg
Blur plates on video
Coming soonEndpoint
POST
https://api.carflowai.com/v1/xxxxxxxxxxxcurl -X POST https://api.carflowai.com/v1/blur-video \-H "Authorization: Bearer sk_live_your_key" \-F "[email protected]" \-o result.mp4
Fehlercodes
| 401 | invalid_api_key | Fehlender, ungültiger oder widerrufener API-Schlüssel |
| 402 | insufficient_credits | Nicht genug Guthaben und Pay-as-you-go nicht aktiviert |
| 429 | rate_limited | Mehr als 60 Anfragen/Minute für diesen Schlüssel |
| 400 | unknown_tool / missing_image / invalid_params | Unbekanntes Tool, fehlendes Bild oder ungültige Parameter |
| 500 | processing_failed | Verarbeitung auf unserer Seite fehlgeschlagen — nicht berechnet |
Pay-as-you-go-Abrechnung folgt in Kürze — bis dahin werden API-Aufrufe von Ihrem bestehenden Guthaben abgebucht.