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>",
  "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>",
        "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": {}
          }
        ]
      }
    ],
    "audios": [
      {
        "hash": "<string>",
        "identifier": "<string>",
        "api_version": "<string>",
        "status": "new",
        "errors": "<string>",
        "name": "<string>",
        "ref_id": "<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": {}
          }
        ]
      }
    ]
  }
}

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.

​
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