Añade herramientas de fotos de coches a tu propio producto

API REST para difuminar matrículas y más — procesa fotos de coches directamente desde tu backend, sin edición manual.

Integración rápida

Una solicitud POST con tu foto — la imagen procesada vuelve en segundos. Sin necesidad de instalar un SDK.

Autenticación por clave

Un único token Bearer vinculado a tu cuenta. Regénéralo o revócalo cuando quieras desde tu panel.

Los mismos modelos que la app

Los mismos modelos de detección y difuminado de matrículas que usa CarFlow AI — listos para producción, no una demo.

Sin facturación aparte

Las llamadas a la API se descuentan de tu saldo de créditos actual, igual que en la app.

Documentación

Difuminar matrículas

Endpoint

POSThttps://api.carflowai.com/v1/blur-plates

curl -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.

Reemplazar matrícula con un diseño personalizado

Endpoint

POSThttps://api.carflowai.com/v1/plate-logo

curl -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.
`logo`or`logoAssetId`	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.

Añadir sombra bajo el coche

Endpoint

POSThttps://api.carflowai.com/v1/car-shadow

curl -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 soon

Endpoint

POSThttps://api.carflowai.com/v1/xxxxxxxxxxx

curl -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 soon

Endpoint

POSThttps://api.carflowai.com/v1/xxxxxxxxxxx

curl -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 soon

Endpoint

POSThttps://api.carflowai.com/v1/xxxxxxxxxxx

curl -X POST https://api.carflowai.com/v1/blur-video \
  -H "Authorization: Bearer sk_live_your_key" \
  -F "[email protected]" \
  -o result.mp4

Códigos de error

401	invalid_api_key	Clave API faltante, inválida o revocada
402	insufficient_credits	Créditos insuficientes y pay-as-you-go no habilitado
429	rate_limited	Más de 60 solicitudes/minuto para esta clave
400	unknown_tool / missing_image / invalid_params	Herramienta desconocida, imagen faltante o parámetros inválidos
500	processing_failed	Error de procesamiento de nuestro lado — no se cobró

La facturación pay-as-you-go llegará pronto — por ahora, las llamadas a la API se cobran de tu saldo de créditos actual.