• Semihuman API Documentation
    • end-points
      • Humanize text
        POST
      • Check AI content
        POST

    Semihuman API Documentation

    Table of Contents#

    1.
    Overview
    2.
    Endpoints
    POST /check-ai
    POST /humanize
    3.
    Definitions
    HumanizeDto
    HumanizeOkDto
    AIDetectionResultDto
    ErrorDto
    4.
    License

    Overview#

    Title: Semihuman
    Version: 1.0.0
    This API provides functionalities to humanize text and check if text is generated by AI.

    Endpoints#

    POST /check-ai#

    Description#

    Checks whether the provided text is AI-generated.

    Headers#

    x-humanizer-api-key (string, required): Humanizer API Key.

    Request Body#

    text (string, required): The text to check for AI generation.
    Example: "Example text to check."

    Constraints#

    Maximum word limit: 10,000 words

    Consumes#

    application/json

    Produces#

    application/json

    POST /humanize#

    Description#

    Humanizes the provided text to make it less AI-like.

    Headers#

    x-humanizer-api-key (string, required): Humanizer API Key.

    Request Body#

    text (string, required): The text to humanize.
    Example: "Example text to humanize."
    aggressiveness (number, optional): The aggressiveness level for humanization (0 to 100). Default is 0.
    Example: 50

    Constraints#

    Maximum word limit: 10,000 words

    Consumes#

    application/json

    Produces#

    application/json

    Definitions#

    HumanizeDto#

    Properties#

    text (string, required): The text to humanize.
    Example: "Example text to humanize."
    aggressiveness (number, optional): The aggressiveness level for humanization (0 to 100). Default is 0.
    Example: 50

    HumanizeOkDto#

    Properties#

    shareToken (string, required): A token that can be used to retrieve the humanized content.
    Example: "exampleToken123"
    humanizedContent (string, nullable): The humanized content, if processing is successful.
    Example: "This is the processed humanized content."
    status (string, required): Status of the processing request.
    Example: "success"

    AIDetectionResultDto#

    Properties#

    message (string, required): Message summarizing the detection result.
    Example: "Detection complete"
    classification (string, required): Classification of the text based on AI detection.
    Example: "AI"
    confidence (number, required): Confidence level of the classification.
    Example: 100
    resultMessage (string, required): Detailed result message.
    Example: "Your text is likely to be written entirely by AI"

    ErrorDto#

    Properties#

    statusCode (number, required): HTTP status code.
    Example: 400
    message (string, required): Description of the error.
    Example: "Invalid API Key"
    error (string, required): Error type.
    Example: "Bad Request"

    License#

    The Semihuman API documentation is provided as is without warranty.
    Next
    Humanize text
    Built with