replaceNumPlateS3-v3

Description

This feature allows image processing using S3 URLs without requiring a predefined template. Users can submit image URLs directly, and the system processes them independently of any template constraints. This enables flexible number plate processing workflows.

Processing Types :

1. AI Processing
Use the following process type to receive AI-generated results:

"processType": "ai"

2. QA / Collaboration Processing
Use the following process type for QA or collaboration-based workflows:

"processType": "collab"

For real-time completion updates, refer to the AI/Collab Processing Webhook Notification Doc.

Limits

Max Upload Limit: 45 URLs per request.

API Request & Response Guidelines

🟢 200 OK

Images Processed Successfully (Number Plate Replacement v3 with Instant AI Result)

Returned when images are processed with instant AI output (S3-based input URLs + processed output URL).

Response Example:

{
  "status": true,
  "message": "Data Processed",
  "data": {
    "batchID": 10000294314,
    "images": [
      {
        "status": true,
        "picID": 679125,
        "s3": "https://cdn-url.com/image.jpg"
      }
    ]
  }
}

Images Processed Successfully (Number Plate Replacement v3 with Collab, manual QA/QC)

Returned when images are processed under collaboration / manual QA/QC workflow.

Response Example:

{
  "status": true,
  "message": "Data Processed",
  "data": {
    "batchID": 10000296956,
    "images": [
      {
        "fileName": "Front-baleno.jpg",
        "error": false,
        "errorMsg": ""
      }
    ]
  }
}

Response Field Details

batchID: Unique batch identifier used for tracking processing

images: Array of uploaded/processed images

status: Boolean indicating success/failure at batch level

AI Mode Fields

status: Processing status of each image

picID: Unique image identifier

s3: URL of AI processed image output (example: https://cdn-url.com/image.jpg)

Collab Mode Fields

fileName: Original uploaded file name

error: Boolean indicating uploading failure

errorMsg: Error message if uploading failed

🟢 200 OK (Business Validation Errors)

Missing numberPlate

{
  "status": false,
  "message": "Number Plate is Required"
}

Missing numPlateProcessor / Invalid Value

{
  "status": false,
  "message": "numPlateProcessor field`s accepted values: [1, 2]"
}

Missing processType

{
  "status": false,
  "message": "processType field`s accepted values: [`ai`, `collab`]"
}

Missing Number Plate S3 (Processor = 2)

{
  "status": false,
  "message": "Provide an image file s3 Url to replace number plate"
}

Insufficient Credits / No Active Plan

{
  "status": false,
  "message": "Insufficient Credits to Process Images."
}

🟠 401 Unauthorized

Missing or Invalid Authorization

Possible causes:

Missing API key

Invalid API key

User not linked to request

{
  "status": false,
  "message": "You are not Authorized"
}

🟠 429 Too Many Requests

Rate Limit Exceeded

Returned when API usage exceeds configured limits.

{
  "status": false,
  "message": "Rate limit exceeded."
}

🔴 500 Internal Server Error

Returned when unexpected failure occurs during:

{
  "status": false,
  "message": "Internal server error"
}

Generic Error Format

{
  "status": false,
  "message": "<error message>",
  "data": []
}

Important Note

Consumers of this API should not rely solely on the HTTP status code. Some validation and business-rule failures may return HTTP 200 OK with "status": false in the response body. Always inspect the status field to determine whether the operation succeeded.

replaceNumPlateS3-v3

API Request & Response Guidelines#

🟢 200 OK#

Images Processed Successfully (Number Plate Replacement v3 with Instant AI Result)#

Images Processed Successfully (Number Plate Replacement v3 with Collab, manual QA/QC)#

Response Field Details#

AI Mode Fields#

Collab Mode Fields#

🟢 200 OK (Business Validation Errors)#

Missing numberPlate#

Missing numPlateProcessor / Invalid Value#

Missing processType#

Missing Number Plate S3 (Processor = 2)#

Insufficient Credits / No Active Plan#

🟠 401 Unauthorized#

Missing or Invalid Authorization#

🟠 429 Too Many Requests#

Rate Limit Exceeded#

🔴 500 Internal Server Error#

Generic Error Format#

Important Note#

Request

Responses