> ## Documentation Index
> Fetch the complete documentation index at: https://docs.budgetpixel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate content NSFW level

> Rate text, images, and/or one video on BudgetPixel's 4-level NSFW scale —
the same classifier and scale the platform itself moderates with.
**Synchronous**: the response carries the verdict.

**Levels:**
- `0` (`sfw`) — safe for work. Non-sexual violence, action, and blood stay here.
- `1` (`teen`) — mildly suggestive (swimwear/underwear in a non-sexual context).
- `2` (`mature`) — partial nudity or overtly sexual posing, no genitals.
- `3` (`x-rated`) — explicit sexual content, visible genitals, or extreme gore.

**Inputs** (at least one required): `prompt` (text), `images` (up to 10, max 10 MB
each), `video` (one, max 100 MB and 5 minutes — 5 frames are sampled). Media
values accept a public URL, an uploaded-file URL from
[`POST /v1/uploads`](/api-reference/files/upload-input-media), a data URI, or raw
base64. Everything is downscaled before classification; the rating is for the
submission **as a whole** (highest applicable level), with one overall `reason`.

**Pricing: 2 credits base + 3 per image + 15 for a video.** Estimate via
[`POST /v1/cost`](/api-reference/models/estimate-the-cost-of-a-request) with
`{"model": "moderation-nsfw", "images": 2, "video": true}`. Charged on success
only — a classifier failure costs nothing.

Submitted media is retained privately for ~1 day (for abuse review), then
deleted automatically.




## OpenAPI

````yaml /openapi.yaml post /moderations/nsfw
openapi: 3.1.0
info:
  contact:
    email: support@budgetpixel.com
    name: BudgetPixel Support
  description: >
    The BudgetPixel developer API for programmatic image and video generation.


    Generation is **asynchronous**: you create a job, then poll its status until
    it

    reaches a terminal state (`succeeded` / `failed`). You are charged in
    credits

    only on success — never for failures, timeouts, or content blocked before

    generation.


    **Authentication.** All requests require an API key sent as a bearer token:

        Authorization: Bearer bpx_live_xxx

    Create and manage keys from your BudgetPixel account dashboard. The
    developer

    API is currently available on the **Ultra** plan.


    **Pricing.** API usage is metered in credits at each model's published price

    (see `GET /v1/models`). Consumer subscription perks (free daily generations,

    free-for-Ultra models, subscription discounts) do not apply to API traffic.
  title: BudgetPixel API
  version: '2026-06-20'
servers:
  - description: Production
    url: https://api.budgetpixel.com/v1
security:
  - ApiKeyAuth: []
tags:
  - description: Account and credit balance
    name: Account
  - description: Discover available models and pricing
    name: Models
  - description: Upload input media for image/video generation
    name: Uploads
  - description: Image job status
    name: Images
  - description: FLUX image models
    name: Black Forest Labs
  - description: SeeDream image models
    name: Bytedance
  - description: Video job status
    name: Videos
  - description: Kuaishou Kling video models
    name: Kling
  - description: SeeDance video models
    name: ByteDance (SeeDance)
  - description: Music job status
    name: Audios
  - description: Music generation models
    name: Music
  - description: Format conversion for images, video, and audio
    name: Conversions
  - description: Publish posts to your BudgetPixel feed
    name: Social
  - description: Content moderation — NSFW rating and CSAM detection
    name: Moderation
  - description: Content classification — music genre detection
    name: Classification
paths:
  /moderations/nsfw:
    post:
      tags:
        - Moderation
      summary: Rate content NSFW level
      description: >
        Rate text, images, and/or one video on BudgetPixel's 4-level NSFW scale
        —

        the same classifier and scale the platform itself moderates with.

        **Synchronous**: the response carries the verdict.


        **Levels:**

        - `0` (`sfw`) — safe for work. Non-sexual violence, action, and blood
        stay here.

        - `1` (`teen`) — mildly suggestive (swimwear/underwear in a non-sexual
        context).

        - `2` (`mature`) — partial nudity or overtly sexual posing, no genitals.

        - `3` (`x-rated`) — explicit sexual content, visible genitals, or
        extreme gore.


        **Inputs** (at least one required): `prompt` (text), `images` (up to 10,
        max 10 MB

        each), `video` (one, max 100 MB and 5 minutes — 5 frames are sampled).
        Media

        values accept a public URL, an uploaded-file URL from

        [`POST /v1/uploads`](/api-reference/files/upload-input-media), a data
        URI, or raw

        base64. Everything is downscaled before classification; the rating is
        for the

        submission **as a whole** (highest applicable level), with one overall
        `reason`.


        **Pricing: 2 credits base + 3 per image + 15 for a video.** Estimate via

        [`POST /v1/cost`](/api-reference/models/estimate-the-cost-of-a-request)
        with

        `{"model": "moderation-nsfw", "images": 2, "video": true}`. Charged on
        success

        only — a classifier failure costs nothing.


        Submitted media is retained privately for ~1 day (for abuse review),
        then

        deleted automatically.
      operationId: moderateNSFW
      requestBody:
        content:
          application/json:
            schema:
              properties:
                images:
                  description: >-
                    Up to 10 images (public URL, uploaded-file URL, data URI, or
                    raw base64). Max 10 MB each.
                  items:
                    type: string
                  maxItems: 10
                  type: array
                prompt:
                  description: Text to rate (alone, or as context for the media).
                  type: string
                video:
                  description: >-
                    One video (public URL, uploaded-file URL, data URI, or raw
                    base64). Max 100 MB and 5 minutes.
                  type: string
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  confidence:
                    description: Classifier confidence, 0-1.
                    type: number
                  credits_charged:
                    type: integer
                  id:
                    description: Moderation request id (audit reference).
                    type: string
                  label:
                    enum:
                      - sfw
                      - teen
                      - mature
                      - x-rated
                    type: string
                  level:
                    description: Overall NSFW level of the submission.
                    enum:
                      - 0
                      - 1
                      - 2
                      - 3
                    type: integer
                  reason:
                    description: Short overall explanation.
                    type: string
                type: object
          description: The rating.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Insufficient credits.
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  responses:
    BadRequest:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: The request was malformed or referenced an unavailable model.
    Unauthorized:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Missing or invalid API key.
    TooManyRequests:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Rate or queue limit reached. Retry after a short delay.
  schemas:
    Error:
      properties:
        error:
          properties:
            code:
              description: Stable machine-readable code.
              example: model_not_available
              type: string
            message:
              type: string
            type:
              description: Error category.
              example: invalid_request_error
              type: string
          required:
            - type
            - code
            - message
          type: object
      required:
        - error
      type: object
  securitySchemes:
    ApiKeyAuth:
      bearerFormat: bpx_live_*
      description: 'API key as a bearer token: Authorization: Bearer bpx_live_xxx'
      scheme: bearer
      type: http

````