curl --request POST \
  --url https://direct.evolink.ai/v1/moderations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "evolink-moderation-1.0",
  "input": [
    {
      "type": "text",
      "text": "I want to kill them."
    }
  ]
}
'

{
  "evolink_summary": {
    "risk_level": "medium",
    "flagged": false,
    "violations": [],
    "max_score": 0.597383272,
    "max_category": "sexual"
  },
  "id": "modr-0d9740456c391e43c445bf0f010940c7",
  "model": "evolink-moderation-1.0",
  "results": [
    {
      "flagged": false,
      "categories": {
        "harassment": false,
        "harassment/threatening": false,
        "hate": false,
        "hate/threatening": false,
        "illicit": false,
        "illicit/violent": false,
        "self-harm": false,
        "self-harm/intent": false,
        "self-harm/instructions": false,
        "sexual": false,
        "sexual/minors": false,
        "violence": false,
        "violence/graphic": false
      },
      "category_scores": {
        "harassment": 0.0006,
        "harassment/threatening": 0.0007,
        "hate": 0.00003,
        "hate/threatening": 0.0000025,
        "illicit": 0.000013,
        "illicit/violent": 0.0000096,
        "self-harm": 0.0000166,
        "self-harm/intent": 0.000004,
        "self-harm/instructions": 0.0000031,
        "sexual": 0.597383272,
        "sexual/minors": 0.000004,
        "violence": 0.0231,
        "violence/graphic": 0.0089
      },
      "category_applied_input_types": {
        "harassment": [
          "text"
        ],
        "harassment/threatening": [
          "text"
        ],
        "hate": [
          "text"
        ],
        "hate/threatening": [
          "text"
        ],
        "illicit": [
          "text"
        ],
        "illicit/violent": [
          "text"
        ],
        "self-harm": [
          "text"
        ],
        "self-harm/intent": [
          "text"
        ],
        "self-harm/instructions": [
          "text"
        ],
        "sexual": [
          "text"
        ],
        "sexual/minors": [
          "text"
        ],
        "violence": [
          "text"
        ],
        "violence/graphic": [
          "text"
        ]
      }
    }
  ]
}

{
  "error": {
    "code": 400,
    "message": "field input is required",
    "type": "invalid_request_error",
    "param": "input"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/billing"
  }
}

{
  "error": {
    "code": 403,
    "message": "Access denied for this model",
    "type": "permission_error",
    "param": "model"
  }
}

{
  "error": {
    "code": 404,
    "message": "Specified model not found",
    "type": "not_found_error",
    "param": "model",
    "fallback_suggestion": "evolink-moderation-1.0"
  }
}

{
  "error": {
    "code": 413,
    "message": "Image file too large",
    "type": "request_too_large_error",
    "param": "input",
    "fallback_suggestion": "compress image to under 20MB"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 502,
    "message": "Bad gateway",
    "type": "bad_gateway_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

EvoLink Moderation

EvoLink Moderation 1.0 - 完全な API リファレンス

同期 API。入力されたテキストおよび/または画像に対して 13 次元の有害コンテンツ検出を行います
レスポンスでは evolink_summary フィールドを通じて risk_level / flagged / violations / max_score / max_category の 5 項目から成る統一サマリーを返却します

主な機能：

マルチモーダル審査：テキストのみ、画像のみ、テキスト + 画像の組み合わせ入力に対応
13 個のカテゴリー：harassment、hate、sexual、violence、self-harm、illicit、sexual/minors など
リスク階層化：各カテゴリーごとに medium / high の閾値を独立に設定し、感度ごとに判定基準を差別化（レッドライン項目 sexual/minors の閾値が最も厳格）
説明可能性：レスポンスでカテゴリーごとの category_scores と簡略化された evolink_summary の両方を返却し、ビジネス側はどちらかを選んで利用可能

入力制約：

1 リクエストあたり画像は最大 1 枚（複数枚を審査したい場合は並列にリクエストを分割してください）
画像は HTTPS URL 入力のみサポート

典型的な使い方：以下のサンプルを参照してください。テキストのみ、テキスト + 画像、画像のみの 3 つの典型的なシナリオを網羅しています。

POST

moderations

curl --request POST \
  --url https://direct.evolink.ai/v1/moderations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "evolink-moderation-1.0",
  "input": [
    {
      "type": "text",
      "text": "I want to kill them."
    }
  ]
}
'

{
  "evolink_summary": {
    "risk_level": "medium",
    "flagged": false,
    "violations": [],
    "max_score": 0.597383272,
    "max_category": "sexual"
  },
  "id": "modr-0d9740456c391e43c445bf0f010940c7",
  "model": "evolink-moderation-1.0",
  "results": [
    {
      "flagged": false,
      "categories": {
        "harassment": false,
        "harassment/threatening": false,
        "hate": false,
        "hate/threatening": false,
        "illicit": false,
        "illicit/violent": false,
        "self-harm": false,
        "self-harm/intent": false,
        "self-harm/instructions": false,
        "sexual": false,
        "sexual/minors": false,
        "violence": false,
        "violence/graphic": false
      },
      "category_scores": {
        "harassment": 0.0006,
        "harassment/threatening": 0.0007,
        "hate": 0.00003,
        "hate/threatening": 0.0000025,
        "illicit": 0.000013,
        "illicit/violent": 0.0000096,
        "self-harm": 0.0000166,
        "self-harm/intent": 0.000004,
        "self-harm/instructions": 0.0000031,
        "sexual": 0.597383272,
        "sexual/minors": 0.000004,
        "violence": 0.0231,
        "violence/graphic": 0.0089
      },
      "category_applied_input_types": {
        "harassment": [
          "text"
        ],
        "harassment/threatening": [
          "text"
        ],
        "hate": [
          "text"
        ],
        "hate/threatening": [
          "text"
        ],
        "illicit": [
          "text"
        ],
        "illicit/violent": [
          "text"
        ],
        "self-harm": [
          "text"
        ],
        "self-harm/intent": [
          "text"
        ],
        "self-harm/instructions": [
          "text"
        ],
        "sexual": [
          "text"
        ],
        "sexual/minors": [
          "text"
        ],
        "violence": [
          "text"
        ],
        "violence/graphic": [
          "text"
        ]
      }
    }
  ]
}

{
  "error": {
    "code": 400,
    "message": "field input is required",
    "type": "invalid_request_error",
    "param": "input"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/billing"
  }
}

{
  "error": {
    "code": 403,
    "message": "Access denied for this model",
    "type": "permission_error",
    "param": "model"
  }
}

{
  "error": {
    "code": 404,
    "message": "Specified model not found",
    "type": "not_found_error",
    "param": "model",
    "fallback_suggestion": "evolink-moderation-1.0"
  }
}

{
  "error": {
    "code": 413,
    "message": "Image file too large",
    "type": "request_too_large_error",
    "param": "input",
    "fallback_suggestion": "compress image to under 20MB"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 502,
    "message": "Bad gateway",
    "type": "bad_gateway_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

BaseURL：デフォルトの BaseURL は https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。

承認

Authorization

string

header

必須

##すべてのエンドポイントには Bearer Token による認証が必要です##

API キーの取得：

API キー管理ページにアクセスして、API キーを取得してください。

リクエストヘッダーに追加：

Authorization: Bearer YOUR_API_KEY

ボディ

application/json

model

enum<string>

必須

モデレーションモデル名。evolink-moderation-1.0 で固定です。

利用可能なオプション:

evolink-moderation-1.0

例:

"evolink-moderation-1.0"

input

(テキスト入力項目 · object | 画像入力項目 · object)[]

必須

審査対象のコンテンツ。すべてオブジェクト配列の形式に統一されています。各要素は text または image_url オブジェクトです。

"input": [
  {"type": "text", "text": "審査対象のテキスト"},
  {"type": "image_url", "image_url": {"url": "https://..."}}
]

制約：

配列内で type=image_url のオブジェクトは最大 1 個。複数枚の画像を審査したい場合は、並列でリクエストを分割してください
type=text のオブジェクト数に制限はありません

テキスト入力項目
画像入力項目

Show child attributes

レスポンス

モデレーション成功

モデレーションレスポンス。最上位の evolink_summary はビジネス側で利用を推奨する統一リスクサマリーです。results はカテゴリーごとの詳細スコアを提供します。

evolink_summary

object

EvoLink リスクサマリー：13 個のカテゴリーの category_scores をベースに、各カテゴリーの感度に応じて差別化された閾値で算出された統一サマリーです。ビジネス側ではこれをもとに直接通過/拒否/レビュー送付を判断できます。

リスク階層化閾値表

カテゴリー	medium 閾値	high 閾値	備考
`sexual/minors`	0.05	0.20	レッドライン項目、最も厳格な閾値
`self-harm` / `self-harm/intent` / `self-harm/instructions`	0.30	0.60	人命に関わるため厳格
`violence/graphic`	0.40	0.70	残虐な暴力
`illicit/violent`	0.40	0.70	暴力的違法行為
`sexual`	0.50	0.80	通常の性的コンテンツ
`violence`	0.50	0.80	通常の暴力
`harassment/threatening`	0.50	0.80	脅迫的ハラスメント
`hate/threatening`	0.50	0.80	脅迫的ヘイト
`harassment`	0.60	0.85	通常のハラスメント
`hate`	0.60	0.85	通常のヘイト
`illicit`	0.60	0.85	通常の違法行為の手引き

判定ルール

いずれかのカテゴリーの score >= 当該カテゴリーの high 閾値   → risk_level = "high",   flagged = true,  violations に追加
いずれかのカテゴリーの score >= 当該カテゴリーの medium 閾値 → risk_level = "medium", flagged = false
それ以外                                                       → risk_level = "low",    flagged = false

ビジネス側の利用ガイダンス

summary = response["evolink_summary"]

if summary["flagged"]:                         # high → 直接拒否
    reject(reason=summary["violations"])
elif summary["risk_level"] == "medium":        # グレーゾーン
    log_for_review(summary)                    # ログ記録、人手によるサンプリングレビュー
    proceed()
else:                                          # low → 通過
    proceed()

Show child attributes

string

本モデレーションリクエストの一意の識別子

例:

"modr-0d9740456c391e43c445bf0f010940c7"

model

string

実際に使用されたモデル名。evolink-moderation-1.0 で固定です。

例:

"evolink-moderation-1.0"

results

object[]

モデレーション結果のリスト。固定で 1 個の result を返します（配列形式の入力は単一のスコア結果に統合されます）。

マルチモーダル評価範囲

13 個のカテゴリーのうち、一部のカテゴリーはテキストのみで評価され、画像は評価されません：

カテゴリー	評価範囲
`harassment` / `harassment/threatening`	テキストのみ
`hate` / `hate/threatening`	テキストのみ
`illicit` / `illicit/violent`	テキストのみ
`sexual/minors`	テキストのみ（要注意：レッドライン項目）
`self-harm` / `self-harm/intent` / `self-harm/instructions`	テキスト + 画像
`sexual`	テキスト + 画像
`violence` / `violence/graphic`	テキスト + 画像

重要事項：

画像のみを送信した場合、上記 7 つのテキスト専用カテゴリーのスコアは常に 0 となり、category_applied_input_types は空配列になります。これはコンテンツが安全であることを意味するのではなく、評価されていないだけです
未成年者リスク（sexual/minors レッドライン項目）に関わるビジネスでは、必ずテキストコンテキストと併せて審査に送る必要があり、画像スコアのみに依存することはできません

Show child attributes

EvoLink Auto - Gemini形式 Kimi K3 - OpenAI 互換 API

画像シリーズ

動画シリーズ

オーディオシリーズ

テキストシリーズ

アカウント管理

タスク管理

ファイル管理

EvoLink Moderation 1.0 - 完全な API リファレンス

承認

ボディ

レスポンス

リスク階層化閾値表

判定ルール

ビジネス側の利用ガイダンス

マルチモーダル評価範囲