Kotlin / Android AI detector quickstart

Send at least 150 characters for a more reliable signal. The response score ranges from 0 (more likely human-written) to 1 (more likely AI-generated); use it as evidence, not proof.

No language-specific SDK is required. The example uses a standard or commonly used HTTP client to call Sapling's JSON API.

Kotlin / Android /api/v1/aidetect

This example uses the HTTP client included with Java 11 and newer.

import java.net.URI
import java.net.http.HttpClient
import java.net.http.HttpRequest
import java.net.http.HttpResponse

fun main() {
    val apiKey = System.getenv("SAPLING_API_KEY")
        ?: error("Set SAPLING_API_KEY first.")
    val payload = """
        {
          "text": "I am an artificial intelligence system designed to help people solve complex problems. My capabilities include natural language processing, machine learning, and predictive analytics.",
          "sent_scores": true
        }
    """.trimIndent()

    val request = HttpRequest.newBuilder()
        .uri(URI.create("https://api.sapling.ai/api/v1/aidetect"))
        .header("Authorization", "Bearer $apiKey")
        .header("Content-Type", "application/json")
        .POST(HttpRequest.BodyPublishers.ofString(payload))
        .build()

    val response = HttpClient.newHttpClient().send(
        request,
        HttpResponse.BodyHandlers.ofString(),
    )

    check(response.statusCode() in 200..299) {
        "Sapling API error ${response.statusCode()}: ${response.body()}"
    }
    println(response.body())
}

Example response application/json

{
  "score": 0.9989,
  "sentence_scores": [
    {
      "score": 0.9764,
      "sentence": "I am an artificial intelligence system designed to help people solve complex problems."
    },
    {
      "score": 0.9812,
      "sentence": "My capabilities include natural language processing, machine learning, and predictive analytics."
    }
  ],
  "text": "I am an artificial intelligence system designed to help people solve complex problems. My capabilities include natural language processing, machine learning, and predictive analytics."
}

The overall score and sentence scores use different methods and may not match exactly. Choose thresholds based on the false-positive and false-negative costs of your use case.

Reference Full AI detector API documentation All languages Choose another quickstart

About Kotlin / Android

Kotlin is a programming language that interoperates with Java on the JVM. While it is cross-platform, widespread adoption of Kotlin stems from its first-class support on the Android platform for Android applications.

Kotlin / Android AI Detector

Kotlin / Android AI detector quickstart