أضف أدوات صور السيارات إلى منتجك الخاص

واجهة REST API لتمويه لوحات السيارات وأكثر، عالج صور السيارات مباشرة من خادمك دون أي تعديل يدوي.

تكامل سريع

طلب POST واحد مع صورتك، وتصلك الصورة المعالجة خلال ثوانٍ. لا حاجة لتثبيت أي SDK.

مصادقة بمفتاح

رمز Bearer واحد مرتبط بحسابك. أعد إنشاءه أو ألغِه في أي وقت من لوحة التحكم.

نفس نماذج التطبيق

نفس نماذج اكتشاف اللوحات وتمويهها التي يعمل بها CarFlow AI، جاهزة للإنتاج وليست نسخة تجريبية.

بدون فوترة منفصلة

تُخصم استدعاءات API من رصيد نقاطك الحالي، بنفس طريقة احتساب التطبيق.

التوثيق

تمويه لوحات السيارات

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.

استبدال اللوحة بتصميم خاص

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.

إضافة ظل أسفل السيارة

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

رموز الأخطاء

401	invalid_api_key	مفتاح API مفقود أو غير صالح أو ملغى
402	insufficient_credits	الرصيد غير كافٍ ولم يتم تفعيل الدفع حسب الاستخدام
429	rate_limited	أكثر من 60 طلبًا في الدقيقة لهذا المفتاح
400	unknown_tool / missing_image / invalid_params	أداة غير معروفة أو صورة مفقودة أو معاملات غير صالحة
500	processing_failed	فشلت المعالجة من جهتنا، ولم يتم الخصم

الدفع حسب الاستخدام قادم قريبًا، وحتى ذلك الحين تُخصم استدعاءات API من رصيد نقاطك الحالي.