Java SDK

Official Java client (Java 17+), built on the JDK HttpClient + Jackson.

Install

Gradle:

implementation("gg.supervisor:supervisor-sdk:0.1.0")

Maven:

<dependency>
  <groupId>gg.supervisor</groupId>
  <artifactId>supervisor-sdk</artifactId>
  <version>0.1.0</version>
</dependency>

Moderate text

import gg.supervisor.sdk.SupervisorClient;
import gg.supervisor.sdk.models.ModerationRequest;

var client = SupervisorClient.builder().apiKey("sk_prod_...").build();

var result = client.moderate(
    ModerationRequest.builder().text("text to check").build());
System.out.println(result.flagged() + " " + result.labels());

Methods

client.moderate(ModerationRequest)            -> ModerationResponse
client.moderateBatch(BatchModerationRequest) -> List<ModerationResponse>
client.checkUsername("user123")              -> UsernameCheckResponse
client.getLabels()                           -> Map<String, String>

Configure the builder with .baseUrl(url) and .timeout(seconds).

Platform API

Moderate on behalf of your own users with a registered platform's credentials (from the dashboard under Platform API).

import gg.supervisor.sdk.PlatformClient;
import gg.supervisor.sdk.models.PlatformModerationRequest;

var p = PlatformClient.builder()
    .clientId("...").clientSecret("sk_platform_...").build();

p.provisionUser("user@example.com");
var result = p.moderate(PlatformModerationRequest.builder()
    .userEmail("user@example.com").text("text to check").build());

Other methods: listUsers(), getUser(id), createCheckout(...), getConnectStatus(). See the Platform API guide.