Check a Prompt

POST

https://api.spicyapi.com/v1/moderations

Run a prompt or conversation through the same screen the generation endpoints use, without generating. Use it to check your end users' prompts before you spend credits, or to power a live indicator in your own UI. Blocked prompts are never charged at generation time either; this endpoint exists so you can tell users why before they hit submit. Flat price of $0.001 per call. Free when called from the SpicyAPI playground. The screen runs three layers: a keyword blocklist, contextual pattern rules, and a semantic classifier that returns per-category probabilities. outcome is allow, review (uncertain; would be declined at generation with a request to reword) or block.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠400

🟠401

🟠402

🟠422

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.spicyapi.com/v1/moderations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "input": "string",
    "messages": [
        {}
    ]
}'

Response Example

{
    "object": "moderation",
    "flagged": false,
    "outcome": "allow",
    "category": null,
    "categories": {
        "minor": 0.03,
        "real_person": 0.01,
        "non_consent": 0.02,
        "bestiality": 0,
        "gore": 0,
        "injection": 0.01
    },
    "layer": "jev",
    "cost_usd": 0.001
}

Modified at 2026-09-21 21:07:45

List Images

Create Video