Rate Image Content

Use POST /image/rate or mynth.image.rate() to classify a single existing image URL. The API creates an async task and returns a taskId. The SDK waits for completion by default; use rateAsync() when you want to poll yourself. For images you generate with Mynth, prefer the rating option on POST /image/generate instead — see Use Content Rating. That path is free with generation and attaches ratings to each image.

Pricing

Standalone rating is billed at $0.0002 per image. You are charged only when the task completes successfully. The cost is reserved up front. If the task fails, the reserve is released. Insufficient balance returns 422 INSUFFICIENT_BALANCE. Generation-time rating on /image/generate is not billed separately — see Use Content Rating.

Rate with the default scale

Mode defaults to nsfw_sfw and returns sfw or nsfw:

import Mynth from "@mynthio/sdk";

const mynth = new Mynth();

const result = await mynth.image.rate({
  url: "https://example.com/photo.webp",
});

console.log(result.level); // "sfw" | "nsfw"
console.log(result.url);
console.log(result.cost);

Default levels

Level	Meaning
`sfw`	Safe for work. No nudity, violence, or other explicit content. Non-erotic lingerie and bikini are allowed.
`nsfw`	Not safe for work. Contains nudity, violence, or other explicit content.

Rating labels describe detected content. They do not override the Mynth Terms of Service.

Task failures

If the image cannot be rated, the task status is failed (not a partial success). The SDK’s wait() throws TaskAsyncTaskFailedError. Common error codes: FETCH_FAILED, RATING_FAILED, UNKNOWN_ERROR.

Use custom rating levels

Provide mode: "custom" with 2–7 levels to replace the default scale:

const result = await mynth.image.rate({
  url: "https://example.com/photo.webp",
  mode: "custom",
  levels: [
    { value: "safe", description: "Safe for all audiences" },
    { value: "sensitive", description: "Contains mature or suggestive content" },
    { value: "explicit", description: "Explicit adult content" },
  ] as const,
});

console.log(result.level); // "safe" | "sensitive" | "explicit"

Constraints (validated on the request):

Constraint	Limit
URLs per request	1
Number of levels	2 to 7
`value` length	1 to 24 characters
`description` length	1 to 150 characters

value is the string returned in level. description is what the rating model uses to choose a level.

Choosing effective levels

Content rating is performed by a vision language model. Results for borderline images may vary between requests. This feature is for high-level, coarse classification — not fine-grained tagging. Broad, clearly separated categories work best:

sfw / nsfw
safe / suggestive / explicit
safe-for-children / safe-for-adults / nsfw
blood / no-blood

Scales that rely on subtle visual distinctions — for example subtle-nudity vs artistic-nudity vs explicit-nudity — are outside the intended scope and may produce inconsistent results. Test thoroughly before relying on custom levels in production.

REST example

curl https://api.mynth.io/image/rate \
  -X POST \
  -H "Authorization: Bearer $MYNTH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.webp"
  }'

Response (201):

{
  "data": {
    "taskId": "tsk_01KE7XWWEQ4MCGWKBQKJ1G47RP",
    "estimatedCost": "0.0002"
  }
}

Poll /tasks/:id for the completed result:

{
  "result": {
    "url": "https://example.com/photo.webp",
    "level": "sfw"
  }
}

Rate without waiting

Use rateAsync() when you want to create the task now and wait later:

const task = await mynth.image.rateAsync({
  url: "https://example.com/photo.webp",
});

console.log(task.id);

const result = await task.wait();
console.log(result.level);

Poll task endpoints or listen for task.image.rate.completed / task.image.rate.failed webhooks — see Async and polling.

How standalone rating fits

You submit one public image URL (or upload a file via the SDK, which converts it to a URL first).
Mynth reserves cost and queues an image.rate task.
On success the result is { url, level }. On failure the task is failed.
You are charged only for successful ratings.

This creates a separate image.rate task (unlike generate-time rating, which runs inside image.generate).

Rate during generation instead

If you want ratings on images Mynth generates, set rating on the generate request. That attaches rating to each successful image, is free with generation, and does not create a separate rate task. See Use Content Rating.

Getting started

Generation

Control and delivery

Image analysis

Integrations

Pricing

Rate with the default scale

Default levels

Task failures

Use custom rating levels

Choosing effective levels

REST example

Rate without waiting

How standalone rating fits

Rate during generation instead

​Pricing

​Rate with the default scale

​Default levels

​Task failures

​Use custom rating levels

​Choosing effective levels

​REST example

​Rate without waiting

​How standalone rating fits

​Rate during generation instead

Pricing

Rate with the default scale

Default levels

Task failures

Use custom rating levels

Choosing effective levels

REST example

Rate without waiting

How standalone rating fits

Rate during generation instead