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 - Vollständige API-Referenz

Synchroner Endpunkt: prüft den eingegebenen Text und/oder das eingegebene Bild in 13 Dimensionen auf schädliche Inhalte
Die Antwort enthält im Feld evolink_summary eine einheitliche Zusammenfassung mit den fünf Werten risk_level / flagged / violations / max_score / max_category

Kernfunktionen:

Multimodale Moderation: unterstützt reinen Text, reines Bild sowie kombinierte Text-+-Bild-Eingaben
13 Kategorien: harassment, hate, sexual, violence, self-harm, illicit, sexual/minors usw.
Risikoabstufung: jede Kategorie hat eigene Schwellenwerte für medium/high und wird je nach Sensibilität differenziert bewertet (die rote-Linie-Kategorie sexual/minors hat den strengsten Schwellenwert)
Erklärbar: die Antwort liefert sowohl die kategorienweisen category_scores als auch die kompakte evolink_summary – die Anwendung kann frei wählen, welche sie nutzt

Eingabebeschränkungen:

Maximal 1 Bild pro Anfrage (für mehrere Bilder bitte parallele Anfragen verwenden)
Bilder werden ausschließlich als HTTPS-URL akzeptiert

Typische Anwendung: siehe die Beispiele unten – sie decken die drei typischen Szenarien reiner Text, Text+Bild sowie reines Bild ab.

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: Die Standard-BaseURL ist https://direct.evolink.ai und bietet bessere Unterstützung für Textmodelle sowie persistente Verbindungen. https://api.evolink.ai ist der primäre Endpunkt für multimodale Dienste und dient bei Textmodellen als Ausweichadresse.

Autorisierungen

Authorization

string

header

erforderlich

##Alle Endpunkte erfordern eine Bearer-Token-Authentifizierung##

API-Key abrufen:

Besuche die API-Key-Verwaltungsseite, um deinen API-Key zu erhalten.

Im Request-Header verwenden:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

erforderlich

Name des Moderationsmodells, fest auf evolink-moderation-1.0 gesetzt

Verfügbare Optionen:

evolink-moderation-1.0

Beispiel:

"evolink-moderation-1.0"

input

(Texteingabe-Element · object | Bildeingabe-Element · object)[]

erforderlich

Der zu moderierende Inhalt, einheitlich als Array von Objekten. Jedes Element ist entweder ein text- oder ein image_url-Objekt.

"input": [
  {"type": "text", "text": "Zu prüfender Text"},
  {"type": "image_url", "image_url": {"url": "https://..."}}
]

Beschränkungen:

Innerhalb des Arrays ist maximal 1 Objekt mit type=image_url erlaubt; bei mehreren Bildern bitte parallele Anfragen senden
Die Anzahl der type=text-Objekte ist nicht beschränkt

Texteingabe-Element
Bildeingabe-Element

Show child attributes

Antwort

Moderation erfolgreich

Moderationsantwort. Auf der obersten Ebene ist evolink_summary die für die Anwendungsseite empfohlene einheitliche Risiko-Zusammenfassung; results enthält die detaillierten Scores pro Kategorie.

evolink_summary

object

EvoLink Risiko-Zusammenfassung: eine einheitliche Zusammenfassung, die auf Basis der category_scores der 13 Kategorien anhand sensibilitätsabhängig differenzierter Schwellenwerte berechnet wird. Die Anwendung kann darauf direkt Freigabe/Ablehnung/Manuelle Prüfung stützen.

Tabelle der Risiko-Schwellenwerte

Kategorie	medium-Schwelle	high-Schwelle	Hinweise
`sexual/minors`	0,05	0,20	Rote-Linie-Kategorie, strengster Schwellenwert
`self-harm` / `self-harm/intent` / `self-harm/instructions`	0,30	0,60	Lebensgefahr betroffen, streng
`violence/graphic`	0,40	0,70	Drastische Gewalt
`illicit/violent`	0,40	0,70	Gewaltsame illegale Inhalte
`sexual`	0,50	0,80	Allgemeine sexuelle Inhalte
`violence`	0,50	0,80	Allgemeine Gewalt
`harassment/threatening`	0,50	0,80	Bedrohliche Belästigung
`hate/threatening`	0,50	0,80	Bedrohlicher Hass
`harassment`	0,60	0,85	Allgemeine Belästigung
`hate`	0,60	0,85	Allgemeiner Hass
`illicit`	0,60	0,85	Allgemeine Anleitung zu illegalen Handlungen

Bewertungsregeln

Irgendeine Kategorie score >= high-Schwelle dieser Kategorie   → risk_level = "high",   flagged = true,  Aufnahme in violations
Irgendeine Kategorie score >= medium-Schwelle dieser Kategorie → risk_level = "medium", flagged = false
Andernfalls                                                    → risk_level = "low",    flagged = false

Empfehlungen für die Anwendungsseite

summary = response["evolink_summary"]

if summary["flagged"]:                         # high → direkt ablehnen
    reject(reason=summary["violations"])
elif summary["risk_level"] == "medium":        # Graubereich
    log_for_review(summary)                    # protokollieren, manuelle Stichprobe
    proceed()
else:                                          # low → freigeben
    proceed()

Show child attributes

string

Eindeutige Kennung dieser Moderationsanfrage

Beispiel:

"modr-0d9740456c391e43c445bf0f010940c7"

model

string

Name des tatsächlich verwendeten Modells, fest auf evolink-moderation-1.0 gesetzt

Beispiel:

"evolink-moderation-1.0"

results

object[]

Liste der Moderationsergebnisse. Es wird stets 1 Ergebnis zurückgegeben (Eingaben in Array-Form werden zu einer einzelnen Bewertung zusammengeführt).

Multimodaler Bewertungsumfang

Von den 13 Kategorien werden einige nur am Text ausgewertet, nicht am Bild:

Kategorie	Bewertungsumfang
`harassment` / `harassment/threatening`	Nur Text
`hate` / `hate/threatening`	Nur Text
`illicit` / `illicit/violent`	Nur Text
`sexual/minors`	Nur Text (rote Linie — besondere Vorsicht)
`self-harm` / `self-harm/intent` / `self-harm/instructions`	Text + Bild
`sexual`	Text + Bild
`violence` / `violence/graphic`	Text + Bild

Wichtige Fakten:

Wird ausschließlich ein Bild übergeben, sind die Scores der oben genannten 7 reinen Text-Kategorien stets 0 und category_applied_input_types ist ein leeres Array – das bedeutet nicht, dass der Inhalt sicher ist, sondern lediglich, dass er nicht bewertet wurde
Befasst sich die Anwendung mit Risiken für Minderjährige (rote-Linie-Kategorie sexual/minors), muss zwingend zusammen mit dem Textkontext geprüft werden – sich nur auf den Bild-Score zu verlassen, ist nicht zulässig

Show child attributes

EvoLink Auto - Gemini-Format Kimi K3 - OpenAI-kompatible API

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

EvoLink Moderation 1.0 - Vollständige API-Referenz

Autorisierungen

Body

Antwort

Tabelle der Risiko-Schwellenwerte

Bewertungsregeln

Empfehlungen für die Anwendungsseite

Multimodaler Bewertungsumfang