Prompt Analyzer | HiddenLayer Documentation

curl -X POST https://api.hiddenlayer.ai/api/v1/submit/prompt-analyzer \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "prompt": "Hello World",
  "output": "Hello, how can I help you today?",
  "model": "mistral-tiny"
}'

{
  "response": {
    "provider": "string",
    "model": "string",
    "prompt": "string",
    "output": "string",
    "unmodified_prompt": "string",
    "unmodified_output": "string"
  },
  "provider": "string",
  "model": "string",
  "verdict": true,
  "categories": {
    "unsafe_input": true,
    "unsafe_output": true,
    "prompt_injection": true,
    "input_dos": true,
    "input_pii": true,
    "output_pii": true,
    "input_code": true,
    "output_code": true,
    "guardrail": true,
    "input_language": true
  },
  "results": {
    "input_block_list_results": {
      "verdict": true,
      "matches": [
        "badToken"
      ],
      "elapsed_ms": 10
    },
    "prompt_injection_classifier_results": [
      {
        "version": 1,
        "verdict": true,
        "probabilities": [
          1
        ],
        "elapsed_ms": 100
      }
    ],
    "input_dos_results": {
      "verdict": true,
      "elapsed_ms": 1.1,
      "embeddings_length": 1.1
    },
    "input_pii_results": {
      "verdict": true,
      "entities": [
        "PHONE_NUMBER"
      ],
      "elapsed_ms": 20
    },
    "output_pii_results": {
      "verdict": true,
      "entities": [
        "LOCATION"
      ],
      "elapsed_ms": 20
    },
    "input_code_results": {
      "verdict": true,
      "elapsed_ms": 1.1
    },
    "output_code_results": {
      "verdict": true,
      "elapsed_ms": 1.1
    },
    "guardrail_results": {
      "verdict": true,
      "elapsed_ms": 1.1,
      "refusal_classifier_results": {
        "version": 1.1,
        "verdict": true,
        "probabilities": [
          1.1
        ],
        "elapsed_ms": 1.1
      }
    },
    "input_url_results": {
      "urls": [
        "string"
      ],
      "elapsed_ms": 1.1
    },
    "output_url_results": {
      "urls": [
        "string"
      ],
      "elapsed_ms": 1.1
    },
    "input_language_results": {
      "verdict": true,
      "language": "string",
      "elapsed_ms": 1.1
    }
  },
  "policy": {
    "block_unsafe": false,
    "block_unsafe_input": false,
    "block_unsafe_output": true,
    "skip_prompt_injection_detection": true,
    "block_prompt_injection": true,
    "prompt_injection_scan_type": "quick",
    "skip_input_pii_detection": true,
    "skip_output_pii_detection": true,
    "block_input_pii": true,
    "block_output_pii": true,
    "redact_input_pii": true,
    "redact_output_pii": true,
    "redact_type": "entity",
    "entity_type": "strict",
    "skip_input_code_detection": true,
    "skip_output_code_detection": true,
    "block_input_code_detection": true,
    "block_output_code_detection": true,
    "skip_guardrail_detection": true,
    "block_guardrail_detection": true,
    "skip_input_url_detection": true,
    "skip_output_url_detection": true,
    "skip_input_dos_detection": true,
    "block_input_dos_detection": true,
    "input_dos_detection_threshold": 4096
  },
  "frameworks": {
    "mitre": [
      {
        "name": "LLM Prompt Injection",
        "label": "AML.T0051"
      }
    ],
    "owasp": [
      {
        "name": "Prompt Injection",
        "label": "LLM01"
      }
    ],
    "owasp:2025": [
      {
        "name": "Prompt Injection",
        "label": "LLM01:2025"
      }
    ]
  },
  "elapsed_ms": 1.1,
  "upstream_elapsed_ms": 1.1
}

Analyze LLM Prompt and Response

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

promptstringRequired

outputstringOptional

modelstringOptional

Response

Successful Prompt Analyzer response

responseobjectOptional

providerstringOptional

modelstringOptional

verdictbooleanOptional

The overall verdict of the analysis

categoriesobjectOptional

The analysis detection categories

resultsobjectOptional

The analysis results

policyobjectOptional

The policy used during analysis

frameworksobjectOptional

The framework labels identified during analysis

elapsed_msdoubleOptional

The time in milliseconds it took to process the request

upstream_elapsed_msdoubleOptional

The time in milliseconds the upstream LLM took to process the request