KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #dsh-plugin #mcp #react #agent #dsh #deepseek-harness

Java-Plagiarism-Checker

★ 28 Open GitHub ↗

This is the official Java SDK for the Copyleaks API, a leading platform for ensuring content integrity. This library provides a seamless way to integrate Copyleaks' powerful services directly into your Java applications.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Copyleaks SDK
The official [Copyleaks](https://copyleaks.com/) Java library, supporting Java versions:Java 11 or higher.

## 🚀 Getting Started
Before you start, ensure you have the following:

*   An active Copyleaks account. If you don’t have one, [Sign up for free](https://copyleaks.com/signup).
*   You can find your API key on the [API Dashboard](https://api.copyleaks.com/dashboard).

Once you have your account and API key:

**Install the SDK**:

Download the latest version from [Maven Central Repository](https://search.maven.org/artifact/com.copyleaks.sdk/copyleaks-java-sdk)

## 📚 Documentation
To learn more about how to use Copyleaks API please check out our [Documentation](https://docs.copyleaks.com/resources/sdks/java/).

## 💡 Usage Examples
Here are some common usage examples for the Copyleaks SDK. You can also see a comprehensive code example in the `example.java` file on our GitHub repository: [example.java](https://github.com/Copyleaks/Java-Plagiarism-Checker/blob/master/src/main/java/example/Example.java).

### Get Authentication Token
This example demonstrates how to log in to the Copyleaks API and obtain an authentication token.

```java
import classes.Copyleaks;
import models.response.CopyleaksAuthToken;

public class ScanExample {
    // --- Your Credentials ---
    private static final String EMAIL_ADDRESS = "YOUR_EMAIL_ADDRESS";
    private static final String KEY = "YOUR_API_KEY";
    // --------------------

public static void main(String[] args) {
        CopyleaksAuthToken token;

// Log in to the Copyleaks API
        System.out.println("Authenticating...");
        token = Copyleaks.login(EMAIL_ADDRESS, KEY);
        System.out.println("✅ Logged in successfully!");
    }
}
```
For a detailed understanding of the authentication process, refer to the Copyleaks Login Endpoint [Documentation](https://docs.copyleaks.com/reference/actions/account/login).
##
### Submit Text for Plagiarism Scan
This example shows how to prepare and submit raw text content for a plagiarism scan.

```java
import classes.Copyleaks;
import models.submissions.CopyleaksFileSubmissionModel;
import models.submissions.properties.SubmissionProperties;
import models.submissions.properties.SubmissionWebhooks;

public class ScanExample {
    // --- Your Credentials ---
    private static final String EMAIL_ADDRESS = "YOUR_EMAIL_ADDRESS";
    private static final String KEY = "YOUR_API_KEY";
    private static final String WEBHOOK_URL = "https://your-server.com/webhook/{STATUS}";
    // --------------------

public static void main(String[] args) {
        String BASE64_FILE_CONTENT = Base64.getEncoder().encodeToString("Hello world".getBytes(StandardCharsets.UTF_8));
        String FILENAME = "hello.txt";
        String scanId = Integer.toString(getRandomNumberInRange(100, 100000));

// Configure webhooks
        SubmissionWebhooks webhooks = new SubmissionWebhooks(WEBHOOK_URL);
        webhooks.setNewResult("https://your.server/webhook/new-results");

// Create submission properties with enhanced configuration
        SubmissionProperties submissionProperties = new SubmissionProperties(webhooks);
        submissionProperties.setSandbox(true); // Turn on sandbox mode. Turn off on production.

// Create the submission model
        CopyleaksFileSubmissionModel model = new CopyleaksFileSubmissionModel(BASE64_FILE_CONTENT, FILENAME, submissionProperties);
        Copyleaks.submitFile(token, scanId, model);
       
    }
}
```
For a full guide please refer to our step by step [Guide](https://docs.copyleaks.com/guides/authenticity/detect-plagiarism-text)

For a detailed understanding of the plagiarism detection process, refer to the Copyleaks Submit Endpoint [Documentation](https://docs.copyleaks.com/reference/actions/scans/submit-file)
##
### AI-Generated Text Detection
Use the AI detection client to determine if content was generated by artificial intelligence.

```java
import classes.Copyleaks;
import models.submissions.aidetection.CopyleaksNaturalLanguageSubmissionModel;
import models.response.aidetection.AIDetectionResponse;

public class ScanExample {
    // --- Your Credentials ---
    private static final String EMAIL_ADDRESS = "YOUR_EMAIL_ADDRESS";
    private static final String KEY = "YOUR_API_KEY";
    // --------------------

public static void main(String[] args) {
        // This example is going to scan text for natural language AI detection.
        String sampleText = "Lions are social animals, living in groups called prides, typically consisting of several females, their offspring, and a few males. Female lions are the primary hunters, working together to catch prey. Lions are known for their strength, teamwork, and complex social structures.";
        
        CopyleaksNaturalLanguageSubmissionModel naturalLanguageSubmissionModel = new CopyleaksNaturalLanguageSubmissionModel(sampleText);
        naturalLanguageSubmissionModel.setSandbox(true);

AIDetectionResponse naturalLanguageAiDetectionResponse = Copyleaks.aiDetectionClient.submitNaturalLanguage(token, scanId, naturalLanguageSubmissionModel);

System.out.println("\nText scanned for AI detection.");
        System.out.println("AI Score: " + naturalLanguageAiDetectionResponse.getSummary().getAi());
    }
}
```
For a full guide please refer to our step by step [Guide](https://docs.copyleaks.com/guides/ai-detector/ai-text-detection/)

For a detailed understanding of the Ai detection process, refer to the Copyleaks detect natural language Endpoint [Documentation](https://docs.copyleaks.com/reference/actions/writer-detector/check/)
##
### Writing Assistant
Get intelligent suggestions for improving grammar, spelling, style, and overall writing quality.

```java
import classes.Copyleaks;
import models.submissions.writingassistant.ScoreWeights;
import models.submissions.writingassistant.CopyleaksWritingAssistantSubmissionModel;
import models.response.writingassitant.WritingAssistantResponse;

public class ScanExample {
    // --- Your Credentials ---
    private static final String EMAIL_ADDRESS = "YOUR_EMAIL_ADDRESS";
    private static final String KEY = "YOUR_API_KEY";
    // --------------------

public static void main(String[] args) {
        // This example is going to text for writing feedback.
        String writingFeedbackText = "Lions are the only cat that live in groups, called pride. A prides typically consists of a few adult males, several feales, and their offspring. This social structure is essential for hunting and raising young cubs. Female lions, or lionesses are the primary hunters of the prid. They work together in cordinated groups to take down prey usually targeting large herbiores like zbras, wildebeest and buffalo. Their teamwork and strategy during hunts highlight the intelligence and coperation that are key to their survival.";
        
        ScoreWeights scoreWeights = new ScoreWeights();
        scoreWeights.setGrammarScoreWeight(0.1);
        scoreWeights.setMechanicsScoreWeight(0.2);
        scoreWeights.setSentenceStructureScoreWeight(0.3);
        scoreWeights.setWordChoiceScoreWeight(0.4);
        
        CopyleaksWritingAssistantSubmissionModel writingAssistantSubmissionModel = new CopyleaksWritingAssistantSubmissionModel(writingFeedbackText);
        writingAssistantSubmissionModel.setScore(scoreWeights);
        writingAssistantSubmissionModel.setSandbox(true);

WritingAssistantResponse writingAssistantResponse = Copyleaks.writingAssistantClient.submitText(token, scanId, writingAssistantSubmissionModel);

System.out.println("\nText scanned for AI detection.");
        System.out.println("Grammer Score: " + writingAssistantResponse.getScore().getCorrections().getGrammarCorrectionsScore());
    }
}
```
For a full guide please refer to our step by step [Guide](https://docs.copyleaks.com/guides/writing/check-grammar/)

For a detailed understanding of the Writing assistant process, refer to the Copyleaks writing feedback Endpoint [Documentation](https://docs.copyleaks.com/reference/actions/writing-assistant/check/)
##
### Text Moderation
Scan and moderate text content for unsafe, inappropriate, or policy-violating material across various categories.

```java
import classes.Copyleaks;
import models.request.TextModeration.CopyleaksTextModerationRequest;
import models.response.textModeration.CopyleaksTextModerationResponseModel;

public class ScanExample {
    // --- Your Credentials ---
    private static final String EMAIL_ADDRESS = "YOUR_EMAIL_ADDRESS";
    private static final String KEY = "YOUR_API_KEY";
    // --------------------

public static void main(String[] args) {

CopyleaksTextModerationLabel[] labelsArray = new CopyleaksTextModerationLabel[] {
                            new CopyleaksTextModerationLabel(CopyleaksTextModerationConstants.ADULT_V1),
                            new CopyleaksTextModerationLabel(CopyleaksTextModerationConstants.TOXIC_V1),
                            new CopyleaksTextModerationLabel(CopyleaksTextModerationConstants.VIOLENT_V1),
                            new CopyleaksTextModerationLabel(CopyleaksTextModerationConstants.PROFANITY_V1),
                            new CopyleaksTextModerationLabel(CopyleaksTextModerationConstants.SELF_HARM_V1),
                            new CopyleaksTextModerationLabel(CopyleaksTextModerationConstants.HARASSMENT_V1),
                            new CopyleaksTextModerationLabel(CopyleaksTextModerationConstants.HATE_SPEECH_V1),
                            new CopyleaksTextModerationLabel(CopyleaksTextModerationConstants.DRUGS_V1),
                            new CopyleaksTextModerationLabel(CopyleaksTextModerationConstants.FIREARMS_V1),
                            new CopyleaksTextModerationLabel(CopyleaksTextModerationConstants.CYBERSECURITY_V1)
                        };

CopyleaksTextModerationRequest request = new CopyleaksTextModerationRequest(
                /* text */ "This is some text to moderate.",
                /* sandbox */ true,
                /* language */ CopyleaksTextModerationLanguages.ENGLISH,
                /* labels */ labelsArray
        );
        CopyleaksTextModerationResponseModel    textModerationResponse = Copyleaks.textModerationClient.submitText(token, scanId, request);

System.out.println("\nText scanned for Text Moderation.");
        System.out.println("Text Moderation Response: " + gson.toJson(textModerationResponse));
    }
}
```
For a full guide please refer to our step by step [Guide](https://docs.copyleaks.com/guides/moderation/moderate-text/)

For a detailed understanding of the Text moderation process, refer to the Copyleaks text moderation Endpoint [Documentation](https://docs.copyleaks.com/reference/actions/text-moderation/check/)
##

### Image Detection

Determine if a given image was generated or partially generated by an AI.

```java
import classes.Copyleaks;
import models.request.AiImageDetection.CopyleaksAiImageDetectionRequestModel;
import models.response.CopyleaksAuthToken;
import models.response.AiImageDetection.CopyleaksAiImageDetectionResponseModel;
import com.google.gson.Gson;
import static java.nio.file.Files.readAllBytes;
import java.nio.file.Paths;
import java.util.Base64;
import java.io.IOException;
import models.constants.CopyleaksAiImageDetectionModels;

public class ScanExample {
    // --- Your Credentials ---
    private static final String EMAIL_ADDRESS = "YOUR_EMAIL_ADDRESS";
    private static final String KEY = "YOUR_API_KEY";
    // --------------------

public static void main(String[] args) {

// Path to the image file to be analyzed
        String imagePath = "PATH TO YOUR IMAGE";
        byte[] imageBytes;

// Read the image file into a byte array
        try {
            imageBytes = readAllBytes(Paths.get(imagePath));
        } catch (IOException e) {
            System.out.println("Failed to read image file: " + e.getMessage());
            e.printStackTrace();
            return;
        }

// Encode the image as Base64
        String base64Image = Base64.getEncoder().encodeToString(imageBytes);

// Create the image detection request model
        CopyleaksAiImageDetectionRequestModel imageDetectionRequest = new CopyleaksAiImageDetectionRequestModel(
            base64Image,
            "my-image.png",
            CopyleaksAiImageDetectionModels.AI_IMAGE_1_ULTRA,
            true
        );
        
        try {
            // Submit the image for AI detection
            CopyleaksAiImageDetectionResponseModel imageDetectionResponse = Copyleaks.aiImageDetectionClient.submit(token, scanId, imageDetectionRequest);

// Output the results
            System.out.println("\nImage scanned for AI Image Detection.");
            System.out.println("Image Detection Response: " + gson.toJson(imageDetectionResponse));
        } catch (Exception e) {
            System.out.println("Error during AI image detection: " + e.getMessage() + "\n");
            e.printStackTrace();
        }
    }
}

```

For a full guide please refer to our step by step [Guide](https://docs.copyleaks.com/guides/ai-detector/ai-image-detection/)

For a detailed understanding of the Image detection process, refer to the Copyleaks image detection Endpoint [Documentation](https://docs.copyleaks.com/reference/actions/ai-image-detector/check/)
##
### Further Resources
*   **Copyleaks API Dashboard:** Manage your API keys, monitor usage, and view analytics from your personalized dashboard. [Access Dashboard](https://api.copyleaks.com/dashboard)
*   **Copyleaks SDK Documentation:** Explore comprehensive guides, API references, and code examples for seamless integration. [Read Documentation](https://docs.copyleaks.com/resources/sdks/overview/)

##
### Support
* If you need assistance, please contact Copyleaks Support via our support portal: Contact Copyleaks [Support](https://help.copyleaks.com/s/contactsupport).
* To arrange a product demonstration, book a demo here: [Booking Link](https://copyleaks.com/book-a-demo).

Java-Plagiarism-Checker

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README