AVF Infer

Submit a video file for asynchronous Anti-Video Forgery (AVF) analysis. This endpoint returns immediately with a request ID that can be used to check the processing status.

Endpoint

POST /api-gateway/avf/infer

Authentication

Requires a valid JWT token in the Authorization header.

Authorization: Bearer <your-jwt-token>

Optional Headers

Header	Description
X-Device-Info	Device information in JSON format. More info
X-Geo-Location	Client geolocation data instead of IP-based lookup. More info
X-Session-ID	Session ID to link transactions. More info

Request

Content-Type: multipart/form-data

Parameter	Type	Required	Description
file	File	Yes	Video file to analyse (max 100MB)

Example Request

curl -X POST 'https://api.biometrysolutions.com/api-gateway/avf/infer' \
  -H 'Authorization: Bearer <your-jwt-token>' \
  -H 'accept: application/json' \
  -F '[email protected];type=video/mp4'

Response

Status: 202 Accepted

The request is accepted for processing. Use the returned request_id to check the status.

{
  "message": "Inference request accepted",
  "data": {
    "success": true,
    "message": "Accepted for processing",
    "prediction": null,
    "confidence": null,
    "score": null,
    "metadata": {
      "request_id": "246fcaf1-0c88-4b21-a96c-05cabefcef55",
      "source_filename": "video.mp4",
      "received_at": 1763007610
    }
  }
}

Response Fields

Field	Type	Description
message	string	Status message
data.success	boolean	Whether the request was accepted
data.message	string	Detailed status message
data.metadata.request_id	string	Unique identifier for tracking the request
data.metadata.source_filename	string	Original filename of uploaded video
data.metadata.received_at	number	Unix timestamp when request was received

Error Responses

Status	Description
400 Bad Request	Invalid file format or missing file
401 Unauthorized	Missing or invalid JWT token
413 Payload Too Large	File exceeds 100MB limit
500 Internal Server Error	Server processing error

Next Steps

After receiving a successful response, use the AVF Status endpoint to check the processing status and retrieve results.