CSAM Detection - Combined API

Hive's Combined CSAM Detection API runs two CSAM (Child Sexual Abuse Material) detection models, created in partnership with Thorn:

Hash Matching: Capable of detecting known CSAM. If there is no match found, we will send the input to the classifier as well.
Classifier: Capable of detecting novel CSAM. Within the response, the classifier makes predictions for three possible classes, assigning each one a confidence scores between 0 and 1, inclusive. The confidence scores for each class sum to 1:
1. pornography: Pornographic media that does not involve children
2. csam: Child sexual abuse material
3. other: Non-pornographic and non-CSAM media

The endpoint returns both models' responses into a single, combined response.

Note: Currently, this API can only accept images as input. We plan to add video capabilities in the near future.

This is an example of a matched response, i.e., a match for the input has been found in Thorn's CSAM database. Note the non-empty reasons and hashes properties, which reflect that CSAM was flagged.

{
  "status": [
    {
      "status": { "code": 200, "message": "SUCCESS" },
      "response": {
        "input": {
          "id": <ID>,
          "created_on": "2025-04-24T00:32:11.782Z",
          "user_id": <USER_ID>,
          "project_id": <PROJECT_ID>
        },
        "output": {
          "file": {
            "fileType": "image",
            "reasons": ["matched"],
            "classifierPrediction": null
          },
          "hashes": [
            {
              "hashType": "saferhashv0",
              "matchTypes": ["CSAM"],
              "reasons": ["matched"],
              "sources": [
                {
                  "hashSet": "test",
                  "matches": [
                    {
                      "sourceId": <SOURCE_ID>,
                      "matchDistance": 45,
                      "matchMetadata": null,
                      "matchTransformations": []
                    }
                  ]
                }
              ],
              "classifierPrediction": null,
              "isLetterboxed": false,
              "startTimestamp": null,
              "endTimestamp": null,
              "frameIndex": null
            }
          ]
        }
      }
    }
  ]
}

This is an example of a non-matched response, i.e., a match for the input has not been found in Thorn's CSAM database. Note that the reasons and hashes arrays are empty.

{
    "status": [
        {
            "status": {
                "code": 200,
                "message": "SUCCESS"
            },
            "response": {
                "input": {
                    "id": <ID>,
                    "created_on": "2025-04-24T00:12:44.137Z",
                    "user_id": <USER_ID>,
                    "project_id": <PROJECT_ID>
                },
                "output": {
                    "file": {
                        "fileType": "image",
                        "reasons": [],
                        "classifierPrediction": {
                            "csam_classifier": {
                                "csam": 0.00003219065911252983,
                                "pornography": 0.001365269417874515,
                                "other": 0.998602569103241
                            }
                        }
                    },
                    "hashes": []
                }
            }
        }
    ]
}