curl

curl https://api.naga.ac/v1/moderations \
  -H "Authorization: Bearer $NAGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "omni-moderation-latest",
  "input": "I want to hurt them."
}'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NAGA_API_KEY"],
    base_url="https://api.naga.ac/v1",
)

result = client.moderations.create(
    model="omni-moderation-latest",
    input="I want to hurt them.",
)
print(result)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.NAGA_API_KEY,
  baseURL: "https://api.naga.ac/v1",
});

const result = await client.moderations.create({
  model: "omni-moderation-latest",
  input: "I want to hurt them.",
});
console.log(result);

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.naga.ac/v1/moderations"

	payload := strings.NewReader("{\n  \"model\": \"omni-moderation-latest\",\n  \"input\": \"I want to hurt them.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "mdr-4tKq7Zc1Nb9Wx2Ry8Vd3Ms6Ph0Q",
  "model": "omni-moderation-latest",
  "results": [
    {
      "flagged": true,
      "categories": {
        "violence": true,
        "harassment": false
      },
      "category_scores": {
        "violence": 0.9124,
        "harassment": 0.0217
      }
    }
  ]
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "invalid_api_key",
    "message": "The provided API key is invalid. Please ensure your API key is correct and active. You can find more information about obtaining a key on our website: https://naga.ac If you just created this key, wait a few minutes and try again."
  }
}

{
  "error": {
    "type": "insufficient_quota",
    "message": "More credits required to process this request. Visit https://naga.ac/dashboard/credits to add credits."
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "rate_limit_exceeded",
    "message": "Rate limit reached. Please try again in 3s."
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

Moderations

Classify content

Classifies text and images against a moderation model’s categories. The response carries an id the gateway mints, mdr- followed by 28 random characters; the model that judged; and results[] with one verdict per moderated item. This operation returns no usage block.

Requires an API key.

model names a model from Naga’s catalog that serves moderations, and the gateway selects a provider for it.

input takes one of three shapes: a single string, an array of strings, or an array of typed parts. A typed part is {"type": "text", "text": …} or {"type": "image_url", "image_url": {"url": …}}, and the two may be mixed. A part carrying any other type is refused, with both accepted types named. An array holds either all strings or all typed parts.

An image url is an http(s) URL or a data: URI carrying the bytes inline. Any other scheme, including file:, is refused while the body is read. A remote URL is fetched before the model is called. A URL that cannot be read, or that exceeds the deployment’s inline-media limit, is refused.

results[] arrives in the order the moderation model returned it and is passed through unchanged, neither padded to the number of inputs nor trimmed to them. Each entry carries four fields.

flagged — whether the item tripped any category. This is the model’s own verdict where it sent one, and “any category true” where it sent categories alone.
categories — the per-category booleans, in the model’s own order. The key set belongs to that model rather than to a fixed list, so the map is read by key.
category_scores — the scores, keyed exactly as categories.
category_applied_input_types — which kinds of input each category was applied to. Present only when the model sends it, and otherwise absent rather than null.

The account is charged on input tokens alone, at the model’s published prices. There is no output side to charge. Moderation models report no usage, so the count is the gateway’s own: text is tokenized here, and every image_url part costs a flat 250 input tokens regardless of the image.

Every response below 200 carries an object under error with a machine-readable type, a human-readable message, and, where the failure concerns one field, param. 429 and 503 carry Retry-After with the seconds to wait.

POST

moderations

curl

curl https://api.naga.ac/v1/moderations \
  -H "Authorization: Bearer $NAGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "omni-moderation-latest",
  "input": "I want to hurt them."
}'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NAGA_API_KEY"],
    base_url="https://api.naga.ac/v1",
)

result = client.moderations.create(
    model="omni-moderation-latest",
    input="I want to hurt them.",
)
print(result)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.NAGA_API_KEY,
  baseURL: "https://api.naga.ac/v1",
});

const result = await client.moderations.create({
  model: "omni-moderation-latest",
  input: "I want to hurt them.",
});
console.log(result);

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.naga.ac/v1/moderations"

	payload := strings.NewReader("{\n  \"model\": \"omni-moderation-latest\",\n  \"input\": \"I want to hurt them.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "mdr-4tKq7Zc1Nb9Wx2Ry8Vd3Ms6Ph0Q",
  "model": "omni-moderation-latest",
  "results": [
    {
      "flagged": true,
      "categories": {
        "violence": true,
        "harassment": false
      },
      "category_scores": {
        "violence": 0.9124,
        "harassment": 0.0217
      }
    }
  ]
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "invalid_api_key",
    "message": "The provided API key is invalid. Please ensure your API key is correct and active. You can find more information about obtaining a key on our website: https://naga.ac If you just created this key, wait a few minutes and try again."
  }
}

{
  "error": {
    "type": "insufficient_quota",
    "message": "More credits required to process this request. Visit https://naga.ac/dashboard/credits to add credits."
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "rate_limit_exceeded",
    "message": "Rate limit reached. Please try again in 3s."
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

Authorizations

Authorization

string

header

required

An account API key. Send it as Authorization: Bearer <key>.

Body

application/json

The request body of POST /v1/moderations.

model

string

required

The moderation model, named by its id or by one of its aliases. A name this gateway does not serve on this route is refused with 400 model_not_found; a name it served and has since retired, with 410 model_deprecated.

input

required

What to moderate. It is billed on tokens counted here rather than reported by the model: text is tokenized locally, and each image_url part costs a flat 250 input tokens whatever the image is.

Response

The verdict. results carries one entry per input, each with the flag, the per-category verdicts and the scores behind them.

The body of a successful POST /v1/moderations. It carries no usage block, unlike the gateway's other non-LLM routes; the request is billed all the same, on tokens counted here rather than reported by the model.

string

required

The identifier of this moderation, minted by the gateway: mdr- followed by 28 random letters and digits. It is Naga's own and matches no identifier the upstream may have used.

model

string

required

The model that moderated, as the canonical id the requested name resolved to — an alias sent in the request comes back resolved here. The value is this gateway's catalog name, not anything the provider reported about itself.

results

object[]

required

The verdicts, in the order the moderation model returned them, normally one per input item. The array is passed through as it came: nothing here pads it out to the number of inputs or trims it to them.

Hide child attributes

results.flagged

boolean

required

Whether this input tripped any category. The moderation model's own verdict when it sent one; when it sent categories without a verdict, the gateway derives this as "any category true".

results.categories

object

required

The per-category booleans the moderation model reported, in its own order. The key set is that model's. There is no fixed list of categories here, and two models need not agree on one, so a client reads the map rather than named keys. A value the model sends as something other than a boolean is read as false.

Hide child attributes

results.categories.{key}

boolean

results.category_scores

object

required

The per-category scores the moderation model reported, keyed exactly like categories. A score the model sends as something other than a number fails the whole request rather than arriving as a zero the caller cannot tell from a real one.

Hide child attributes

results.category_scores.{key}

number<double>

results.category_applied_input_types

object | null

Which kinds of input each category was applied to, as the moderation model labeled them. Sent only when the model sends it: the key is absent from the body otherwise, never null.

Hide child attributes

results.category_applied_input_types.{key}

string[]

Overview

Endpoints

Classify content

Authorizations

Body

Response