Skip to main content
Get single video classification result
curl --request GET \
  --url https://backend.identifai.net/api/classification_video/{identifier} \
  --header 'X-Api-Key: <api-key>'
{
  "hash": "<string>",
  "identifier": "<string>",
  "api_version": "<string>",
  "status": "new",
  "errors": "<string>",
  "name": "<string>",
  "ref_id": "<string>",
  "result_url": "<string>",
  "is_nsfw": true,
  "verdict": {
    "heuristic": "<string>",
    "confidence": 123,
    "classification": "human",
    "count": 123,
    "models": [
      "<string>"
    ],
    "unknown": true
  },
  "verdicts": [
    {
      "heuristic": "<string>",
      "confidence": 123,
      "classification": "human",
      "count": 123,
      "models": [
        "<string>"
      ],
      "unknown": true
    }
  ],
  "force_classification": "human",
  "results": {
    "images": [
      {
        "hash": "<string>",
        "identifier": "<string>",
        "api_version": "<string>",
        "status": "new",
        "errors": "<string>",
        "name": "<string>",
        "ref_id": "<string>",
        "result_url": "<string>",
        "is_nsfw": true,
        "c2pa": {
          "manifests": {},
          "active_manifest": "<string>",
          "validation_state": "Valid",
          "validation_status": [
            {
              "url": "<string>",
              "code": "<string>",
              "explanation": "<string>"
            }
          ],
          "validation_results": {
            "activeManifest": {
              "failure": [
                {}
              ],
              "success": [
                {}
              ],
              "informational": [
                {}
              ]
            },
            "ingredientDeltas": [
              {}
            ]
          }
        },
        "has_heatmap": true,
        "verdict": {
          "heuristic": "<string>",
          "confidence": 123,
          "classification": "human",
          "models": [
            "<string>"
          ]
        },
        "verdicts": [
          {
            "heuristic": "<string>",
            "confidence": 123,
            "classification": "human",
            "models": [
              "<string>"
            ]
          }
        ],
        "force_classification": "human",
        "results": [
          {
            "model": "<string>",
            "unknown": true,
            "elapsed_time": 123,
            "classification": [
              {
                "label": "human",
                "score": 123
              }
            ],
            "classification_details": {}
          }
        ],
        "details": [
          {
            "detections": [
              {
                "box": {
                  "x1": 123,
                  "x2": 123,
                  "y1": 123,
                  "y2": 123
                },
                "results": [
                  {
                    "model": "<string>",
                    "unknown": true,
                    "elapsed_time": 123,
                    "classification": [
                      {
                        "label": "<string>",
                        "score": 123
                      }
                    ],
                    "classification_details": {
                      "confidence": 123
                    }
                  }
                ],
                "verdict": {
                  "heuristic": "<string>",
                  "confidence": 123,
                  "classification": "<string>"
                }
              }
            ]
          }
        ]
      }
    ],
    "audios": [
      {
        "hash": "<string>",
        "identifier": "<string>",
        "api_version": "<string>",
        "status": "new",
        "errors": "<string>",
        "name": "<string>",
        "ref_id": "<string>",
        "result_url": "<string>",
        "verdict": {
          "heuristic": "<string>",
          "confidence": 123,
          "classification": "human",
          "models": [
            "<string>"
          ]
        },
        "verdicts": [
          {
            "heuristic": "<string>",
            "confidence": 123,
            "classification": "human",
            "models": [
              "<string>"
            ]
          }
        ],
        "force_classification": "human",
        "results": [
          {
            "model": "<string>",
            "unknown": true,
            "elapsed_time": 123,
            "classification": [
              {
                "label": "human",
                "score": 123
              }
            ],
            "classification_details": {}
          }
        ],
        "details": {
          "clips": [
            {
              "index": 123,
              "start": 123,
              "end": 123,
              "results": [
                {
                  "model": "<string>",
                  "unknown": true,
                  "elapsed_time": 123,
                  "classification": [
                    {
                      "label": "human",
                      "score": 123
                    }
                  ],
                  "classification_details": {}
                }
              ],
              "verdict": {
                "heuristic": "<string>",
                "confidence": 123,
                "classification": "human",
                "models": [
                  "<string>"
                ]
              }
            }
          ]
        }
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.identifai.net/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Api-Key
string
header
required

Your API key.

Path Parameters

​
identifier
string
required

The identifier of the video.

Response

The classification result.

The answer for video classification

​
hash
string

SHA-256 hash of the classified video file

​
identifier
string

The identifier that identifies the classified video

​
api_version
string | null

The API version at the time of the analysis (available from v1.1.0). The value is set when the analysis completes.

​
status
enum<string>

The processing status of the classification request (available from v1.1.0)

Available options:
new,
done,
errored
​
errors
string | null

Error messages if the status is 'errored' (available from v1.1.0)

​
name
string

The name of the classified video file

​
ref_id
string

An optional reference ID to associate with the classification request.

​
result_url
string<uri>

URL where the classification results can be found on the dashboard

​
is_nsfw
boolean | null

Indicates if NSFW (Not Safe For Work) content was detected. Only present if with_nsfw was set to true in the classification request.

​
verdict
object

The main classification verdict for the entire video using the user's default heuristic

​
verdicts
object[]

Array of verdicts for all available heuristics applied to the entire video

​
force_classification
enum<string> | null

If present, indicates that the user has forced the classification to the specified value

Available options:
human,
artificial
​
results
object

Detailed results containing analyzed frames from the video