Moderation API reference

Overview

Request

Set modality to text, image, or video. Text uses text; image and video use an Artany-processable HTTP(S) url.

curl -X POST "https://api.artany.ai/v1/moderations" \
  -H "Authorization: Bearer $ARTANY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: moderation-20260722-001" \
  -d '{"modality":"image","url":"https://cdn.example.com/upload.jpg"}'

Response

classes contains Artany labels and confidence scores. Video results also include a frame timestamp in seconds. Artany initially returns decision: "review"; enforce your own allow/review/block policy from the returned classes.

{
  "provider": "artany",
  "decision": "review",
  "classes": [{ "label": "general_nsfw", "score": 0.91, "time": 0 }],
  "billing": { "charged_credits": "2", "idempotent": false }
}

Billing & idempotency

• Text, image, and video are billed per request at the published Moderation API price.
• Credits are pre-authorized before processing and automatically returned if the request cannot be processed.
• Retrying an identical request with the same Idempotency-Key returns the saved result without another charge.

Policy integration

Treat Artany moderation signals as an input to your policy. A typical implementation blocks clearly disallowed labels above a strict threshold, sends uncertain scores to review, and retains the returned classes and request identifier for auditability. Do not depend on a fixed label list: the available labels evolve with the service.

Errors