Source: https://01router.com/docs/moderations Base URL: https://01router.com/api/v1 # Content moderation Review text, images and videos without generating anything. Returns an overall verdict plus a result per content type. Text and images are free; a request with videos costs 1 credit. `POST /api/v1/moderations` Bearer API key ## Results and categories Every result is "none" (not reviewed: turned off, there was nothing of that type, or the review failed), true (passed) or false (blocked). A type fails when any category scores 0.5 or more. Categories: sexual (nudity or sexual content), violence (graphic violence or gore), minor_sexual (sexual content involving anyone who may be under 18), real_person_sexual (an identifiable real person shown nude, sexually or degraded), and prohibited (the content was refused outright; it has no scores). Long text is reviewed by its first and last 10,000 characters. A file that cannot be fetched, is too large, is longer than 10 minutes or is not MP4/MOV returns 400 content_unreadable. ## The moderation field on generations and chat Generations (POST and GET /generations, callbacks) and non-streamed chat completions also carry a moderation object: result, then text, image and video, each with its own result and the input and output checks. Which inputs and outputs are reviewed is set per project (all by default); calls without a project follow the platform setting, and the playground always reviews everything. Blocked input fails with 400 content_policy_violation before anything is charged, and the error body includes moderation. Blocked output fails the generation and refunds its credits. Streamed chat output is not reviewed; the X-Gateway-Moderation response header carries the input's overall result. ## Input parameters | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | text | string \| string[] | no | Text to review: one string or up to 20 strings (reviewed together). | | | images | string[] | no | Up to 8 image URLs (https or data:image), 8MB each. | | | videos | string[] | no | Up to 2 video URLs (https or data:video): MP4 or MOV, up to 20MB and 10 minutes each. | | ## Response fields | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | mod_… | | | object | "moderation" | — | moderation | | | result | "none" \| true \| false | — | Overall verdict: false if any type failed, true if something passed, "none" if nothing was reviewed. | | | text / image / video | object | — | Result per type: result ("none" \| true \| false), category (the highest-scoring category that failed), scores (0-1 per category) and error (why it could not be reviewed). | | | credits | number | — | Credits charged: 0 for text and images, 1 when the request includes videos (returned if the review cannot run). | | ## Usage notes - Pricing and limits: text is free; images are free up to 1,000 per account per UTC day; a request with videos costs 1 credit whatever their number (up to 2), refunded when the review cannot run. Each account may have 5 requests running at once. Over a limit you get 429 moderation_limit with a Retry-After header; without enough credits, 402. ## cURL ```bash curl 'https://01router.com/api/v1/moderations' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "A golden retriever puppy playing in a sunny park", "images": [ "https://example.com/photo.jpg" ] }' ``` ## 200 · application/json ```json { "id": "mod_example", "object": "moderation", "result": false, "text": { "result": true, "scores": { "sexual": 0.0006, "violence": 0.0008, "minor_sexual": 0.0007, "real_person_sexual": 0.0008 } }, "image": { "result": false, "category": "violence", "scores": { "sexual": 0.012, "violence": 0.9817, "minor_sexual": 0.0007, "real_person_sexual": 0.0008 } }, "video": { "result": "none" }, "credits": 0 } ```