Winston AI

https://docs.gowinston.ai/
Admin
Winston AI is an API platform that provides AI content detection, plagiarism detection,...
Tokens:13,942
Snippets:59
Trust Score:10
Update:6 months ago
Show doc for...
Tokens:
Raw
### List Available Tools via cURL

Source: https://docs.gowinston.ai/api-reference/mcp-server

Use this cURL command to list all available tools on the MCP server. This helps in discovering the methods you can call.

```bash
curl --location 'https://api.gowinston.ai/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json' \
--header 'jsonrpc: 2.0' \
--data '{ 
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 1
}'
```

--------------------------------

### MCP Server API - List Tools

Source: https://docs.gowinston.ai/api-reference/mcp-server

This endpoint allows you to list all available tools supported by the MCP Server.

```APIDOC
## POST /mcp/v1

### Description
Fetches a list of all available tools that can be called via the MCP Server.

### Method
POST

### Endpoint
https://api.gowinston.ai/mcp/v1

### Request Body
```json
{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 1
}
```

### Response
#### Success Response (200)
- **result** (array) - A list of available tool names.
- **id** (integer) - The correlation ID of the request.
- **jsonrpc** (string) - The JSON-RPC protocol version.

#### Response Example
```json
{
  "jsonrpc": "2.0",
  "result": [
    "ai-text-detection",
    "ai-image-detection",
    "plagiarism-detection",
    "text-compare"
  ],
  "id": 1
}
```
```

--------------------------------

### Claude Desktop MCP Server Configuration

Source: https://docs.gowinston.ai/api-reference/mcp-server

Configuration for integrating the Winston AI MCP server with Claude Desktop. This requires specifying the command to run the server and environment variables.

```json
{
  "mcpServers": {
    "winston-ai-mcp": {
      "command": "npx",
      "args": ["-y", "winston-ai-mcp"],
      "env": {
        "WINSTONAI_API_KEY": "your-api-key"
      }
    }
  }
}
```

--------------------------------

### POST /v2/text-compare

Source: https://docs.gowinston.ai/api-reference/v2/text-compare/post

Compare two texts to find similarities and differences. This endpoint analyzes both texts and returns detailed information about matching content, word counts, and similarity scores.

```APIDOC
## POST /v2/text-compare

### Description
Compare two texts to find similarities and differences between them. This endpoint analyzes both texts and returns detailed information about matching content, word counts, and similarity scores.

### Method
POST

### Endpoint
https://api.gowinston.ai/v2/text-compare

### Parameters
#### Request Body
- **first_text** (string) - Required - The first text to compare. Maximum 120,000 characters.
- **second_text** (string) - Required - The second text to compare against the first text. Maximum 120,000 characters.

### Request Example
```json
{
  "first_text": "This is the first text.",
  "second_text": "This is the second text."
}
```

### Response
#### Success Response (200)
- **status** (integer) - HTTP status code representing the result of the text comparison request
- **similarity_score** (number) - Overall similarity score between the two texts (0-100).
  0 means no similarity, 100 means identical.
- **first_text** (object) - Information about the first text.
  - **total_word_count** (integer) - Total number of words in the first text

#### Response Example
```json
{
  "status": 200,
  "similarity_score": 85.5,
  "first_text": {
    "total_word_count": 5
  }
}
```

#### Error Responses
- **400 Bad Request**: The request was invalid and could not be processed. Make sure you pass valid arguments.
- **401 Unauthorized**: Pass a valid API key in the Authorization header as a Bearer token.
- **402 Payment Required**: Insufficient credits. Make sure you have enough credits to make the request.
- **403 Forbidden**: The request was forbidden. Make sure you pass a valid URL or document that we can access.
- **429 Too Many Requests**: You have exceeded the rate limit. Please try again later.
- **500 Internal Server Error**: An unexpected error occurred. Please try again later.
```

--------------------------------

### Text Comparison via cURL

Source: https://docs.gowinston.ai/api-reference/mcp-server

Compare two texts for similarity using the 'text-compare' method. Provide both texts and your API key for the analysis.

```bash
curl --location 'https://api.gowinston.ai/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json' \
--data '{ 
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "text-compare",
    "arguments": {
      "first_text": "First text to compare",
      "second_text": "Second text to compare",
      "apiKey": "your-winston-ai-api-key"
    }
  }
}'
```

--------------------------------

### Plagiarism Detection via cURL

Source: https://docs.gowinston.ai/api-reference/mcp-server

Check for plagiarism by submitting text to the MCP server. The text must meet a minimum character count for analysis.

```bash
curl --location 'https://api.gowinston.ai/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json' \
--data '{ 
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "plagiarism-detection",
    "arguments": {
      "text": "Text to check for plagiarism (minimum 100 characters)",
      "apiKey": "your-winston-ai-api-key"
    }
  }
}'
```

--------------------------------

### MCP Server API - AI Image Detection

Source: https://docs.gowinston.ai/api-reference/mcp-server

Identifies AI-generated images, detects C2PA metadata, and watermarks.

```APIDOC
## POST /mcp/v1

### Description
Performs AI image detection to identify AI-generated images, C2PA metadata, and watermarks.

### Method
POST

### Endpoint
https://api.gowinston.ai/mcp/v1

### Parameters
#### Request Body
- **jsonrpc** (string) - Required - The JSON-RPC protocol version, should be "2.0".
- **id** (integer) - Required - A unique identifier for the request.
- **method** (string) - Required - The method to call, should be "tools/call".
- **params** (object) - Required - Parameters for the tool call.
  - **name** (string) - Required - The name of the tool, should be "ai-image-detection".
  - **arguments** (object) - Required - Arguments for the "ai-image-detection" tool.
    - **url** (string) - Required - The URL of the image to analyze.
    - **apiKey** (string) - Required - Your Winston AI API key.
```

--------------------------------

### MCP Server API - Text Comparison

Source: https://docs.gowinston.ai/api-reference/mcp-server

Performs bidirectional similarity analysis between two provided texts.

```APIDOC
## POST /mcp/v1

### Description
Performs a bidirectional similarity analysis between two texts.

### Method
POST

### Endpoint
https://api.gowinston.ai/mcp/v1

### Parameters
#### Request Body
- **jsonrpc** (string) - Required - The JSON-RPC protocol version, should be "2.0".
- **id** (integer) - Required - A unique identifier for the request.
- **method** (string) - Required - The method to call, should be "tools/call".
- **params** (object) - Required - Parameters for the tool call.
  - **name** (string) - Required - The name of the tool, should be "text-compare".
  - **arguments** (object) - Required - Arguments for the "text-compare" tool.
    - **first_text** (string) - Required - The first text to compare.
    - **second_text** (string) - Required - The second text to compare.
    - **apiKey** (string) - Required - Your Winston AI API key.
```

--------------------------------

### AI Text Detection via cURL

Source: https://docs.gowinston.ai/api-reference/mcp-server

Perform AI text detection by sending a POST request with the text and API key. Ensure the text meets the minimum character requirement.

```bash
curl --location 'https://api.gowinston.ai/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json' \
--data '{ 
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ai-text-detection",
    "arguments": {
      "text": "Your text to analyze (minimum 300 characters)",
      "apiKey": "your-winston-ai-api-key"
    }
  }
}'
```

--------------------------------

### POST /v2/ai-content-detection

Source: https://docs.gowinston.ai/api-reference/v2/ai-content-detection/post

Endpoint to submit text for AI content detection and receive a Human Score.

```APIDOC
## POST /v2/ai-content-detection

### Description
The Human Score is a metric used by Winston AI to estimate the likelihood that a given piece of content was generated by an AI tool versus being written by a human.

### Method
POST

### Endpoint
/v2/ai-content-detection

### Parameters
#### Request Body
- **text** (string) - Required - The text content to be analyzed.

### Response
#### Success Response (200)
- **AiContentDetection-response** (object) - The result of the AI content detection analysis.

#### Error Responses
- **400** - Bad Request
- **401** - Unauthorized
- **402** - Payment Required (insufficient credits)
- **403** - Forbidden
- **415** - Unsupported Media Type
- **429** - Too Many Requests
- **500** - Internal Server Error
- **503** - Service Unavailable
```

--------------------------------

### POST /v2/fact-checker

Source: https://docs.gowinston.ai/api-reference/v2/fact-checker/post

Verifies the accuracy of provided content by checking it against trusted sources.

```APIDOC
## POST /v2/fact-checker

### Description
The Fact Checker endpoint is a powerful tool designed to verify the accuracy of a given piece of content by checking it against a variety of trusted sources. The cost is 2 credits per word.

### Method
POST

### Endpoint
/v2/fact-checker

### Parameters
#### Request Body
- **text** (string) - Required - The content to be verified.

### Response
#### Success Response (200)
- **FactCheckerResponse** (object) - The result of the fact-checking process.

#### Error Responses
- **400** (Bad Request) - Invalid arguments.
- **401** (Unauthorized) - Missing or invalid Bearer token.
- **402** (Payment Required) - Insufficient credits.
- **403** (Forbidden) - Access denied to the provided URL or document.
- **415** (Unsupported Media Type) - Invalid content type.
- **429** (Too Many Requests) - Rate limit exceeded.
- **500** (Internal Server Error) - Unexpected server error.
- **503** (Service Unavailable) - Service temporarily unavailable.
```

--------------------------------

### Authentication

Source: https://docs.gowinston.ai/api-reference/v2/ai-content-detection/post

Authentication requirements for accessing the API.

```APIDOC
## Authentication

### Security Scheme
- **bearerAuth** (http) - Uses the Bearer authentication scheme.
```

--------------------------------

### POST /fact-check

Source: https://docs.gowinston.ai/api-reference/v2/fact-checker/post

Analyzes provided text, file, or website content to detect and verify factual claims.

```APIDOC
## POST /fact-check

### Description
Analyzes the input content to extract claims and verify their accuracy against known facts.

### Method
POST

### Endpoint
/fact-check

### Parameters
#### Request Body
- **text** (string) - Optional - The text to scan (300-10,000 characters).
- **file** (string) - Optional - Publicly accessible URL to a .pdf, .doc, or .docx file.
- **website** (string) - Optional - Publicly accessible website URL to fetch and scan.
- **language** (string) - Optional - 2-letter language code (default: auto).

### Response
#### Success Response (200)
- **status** (integer) - HTTP status code.
- **claims** (array) - List of detected claims with verdicts and explanations.
- **score** (integer) - Overall confidence score (0-100).
- **claimsCount** (integer) - Total number of claims extracted.
- **text** (string) - The original analyzed text.
- **sentences** (array) - List of sentences with IDs.

#### Response Example
{
  "status": 200,
  "claims": [
    {
      "id": 1,
      "sentence": "The sky is blue.",
      "claim": "The sky is blue.",
      "verdict": "SUPPORTED",
      "score": 100,
      "explanation": "Scientific consensus confirms the Rayleigh scattering effect.",
      "links": [{"url": "https://example.com", "title": "Science Daily"}]
    }
  ],
  "score": 100,
  "claimsCount": 1,
  "text": "The sky is blue.",
  "sentences": [{"id": 1, "text": "The sky is blue."}]
}
```

--------------------------------

### OpenAPI Specification for Image Detection

Source: https://docs.gowinston.ai/api-reference/v2/image-detection/post

Defines the POST endpoint for image detection, including request body requirements and potential error responses.

```yaml
openapi: 3.0.1
info:
  title: Winston AI API
  description: Winston AI API specification
  license:
    name: MIT
  version: 4.11.4
servers:
  - url: https://api.gowinston.ai/
security:
  - bearerAuth: []
paths:
  /v2/image-detection:
    post:
      description: >-
        Our image detection feature enables AI-generated image detection by
        verifying image metadata and using a machine learning system trained to
        differentiate between human and AI-generated images.
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageDetection'
        required: true
      responses:
        '200':
          description: Image detection Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageDetection-Response'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: BAD_REQUEST
                  description:
                    type: string
                    default: >-
                      The request was invalid and could not be processed. Make
                      sure you pass valid arguments.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: UNAUTHORIZED
                  description:
                    type: string
                    default: >-
                      Pass a valid API key in the Authorization header as a
                      Bearer token.
        '402':
          description: Payment Required (insufficient credits)
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: PAYMENT_REQUIRED
                  description:
                    type: string
                    default: >-
                      Insufficient credits. Make sure you have enough credits to
                      make the request.
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: FORBIDDEN
                  description:
                    type: string
                    default: >-
                      The request was forbidden. Make sure you pass a valid URL
                      or document that we can access.
        '415':
          description: Unsupported Media Type
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: UNSUPPORTED_MEDIA_TYPE
                  description:
                    type: string
                    default: >-
                      The request content type is not supported. Make sure you
                      pass a valid content type.
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: TOO_MANY_REQUESTS
                  description:
                    type: string
                    default: You have exceeded the rate limit. Please try again later.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: INTERNAL_SERVER_ERROR
                  description:
                    type: string
                    default: An unexpected error occurred. Please try again later.
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: SERVICE_UNAVAILABLE
                  description:
                    type: string
                    default: >-
                      The service is currently unavailable. Please try again
                      later.
components:
  schemas:
    ImageDetection:
      required:
        - url
      type: object
      properties:
        url:
```

--------------------------------

### MCP Server Base URL

Source: https://docs.gowinston.ai/api-reference/mcp-server

The base URL for the Host MCP server. This is used to direct API requests.

```bash
https://api.gowinston.ai/mcp/v1
```

--------------------------------

### OpenAPI Specification for AI Content Detection

Source: https://docs.gowinston.ai/api-reference/v2/ai-content-detection/post

This OpenAPI 3.0.1 specification defines the POST /v2/ai-content-detection endpoint. It includes details on request body, responses, and error codes.

```yaml
openapi: 3.0.1
info:
  title: Winston AI API
  description: Winston AI API specification
  license:
    name: MIT
  version: 4.11.4
servers:
  - url: https://api.gowinston.ai/
security:
  - bearerAuth: []
paths:
  /v2/ai-content-detection:
    post:
      description: >-
        The Human Score is a metric used by Winston AI to estimate the
        likelihood that a given piece of content was generated by an AI tool
        versus being written by a human.
      requestBody:
        description: The Ai content detection request V2
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AiContentDetection'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AiContentDetection-response'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: BAD_REQUEST
                  description:
                    type: string
                    default: >-
                      The request was invalid and could not be processed. Make
                      sure you pass valid arguments.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: UNAUTHORIZED
                  description:
                    type: string
                    default: >-
                      Pass a valid API key in the Authorization header as a
                      Bearer token.
        '402':
          description: Payment Required (insufficient credits)
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: PAYMENT_REQUIRED
                  description:
                    type: string
                    default: >-
                      Insufficient credits. Make sure you have enough credits to
                      make the request.
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: FORBIDDEN
                  description:
                    type: string
                    default: >-
                      The request was forbidden. Make sure you pass a valid URL
                      or document that we can access.
        '415':
          description: Unsupported Media Type
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: UNSUPPORTED_MEDIA_TYPE
                  description:
                    type: string
                    default: >-
                      The request content type is not supported. Make sure you
                      pass a valid content type.
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: TOO_MANY_REQUESTS
                  description:
                    type: string
                    default: You have exceeded the rate limit. Please try again later.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: INTERNAL_SERVER_ERROR
                  description:
                    type: string
                    default: An unexpected error occurred. Please try again later.
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: SERVICE_UNAVAILABLE
                  description:
                    type: string
                    default: >-
                      The service is currently unavailable. Please try again
                      later.
components:
  schemas:
    AiContentDetection:
      type: object
      required:
        - text
      properties:

```

--------------------------------

### POST /plagiarism-v2

Source: https://docs.gowinston.ai/api-reference/v2/plagiarism/post

Submit content for a plagiarism scan. The API prioritizes input in the order: website > file > text.

```APIDOC
## POST /plagiarism-v2

### Description
Submits text, a file URL, or a website URL to be scanned for plagiarism. The service automatically detects the language if not specified.

### Method
POST

### Endpoint
/plagiarism-v2

### Parameters
#### Request Body
- **text** (string) - Required - The text to be scanned (100-120,000 characters).
- **file** (string) - Optional - A publicly accessible URL to a .pdf, .doc, or .docx file.
- **website** (string) - Optional - A website URL to fetch and scan.
- **excluded_sources** (array) - Optional - List of domains or URLs to exclude from the scan.
- **language** (string) - Optional - 2-letter language code (default: auto).
- **country** (string) - Optional - Country code of origin (default: us).

### Request Example
{
  "text": "Sample text to be scanned for plagiarism...",
  "language": "en"
}

### Response
#### Success Response (200)
- **status** (number) - HTTP status code.
- **scanInformation** (object) - Metadata about the scan request.
- **result** (object) - The plagiarism scan results including score and word counts.

#### Response Example
{
  "status": 200,
  "scanInformation": {
    "service": "plagiarism-v2",
    "scanTime": "2023-10-27T10:00:00Z",
    "inputType": "text",
    "language": "en"
  },
  "result": {
    "score": 0.05,
    "sourceCounts": 1,
    "textWordCounts": 500,
    "totalPlagiarismWords": 25,
    "identicalWordCounts": 20
  }
}
```

--------------------------------

### MCP Server API - Plagiarism Detection

Source: https://docs.gowinston.ai/api-reference/mcp-server

Conducts internet-scale plagiarism scans and provides detailed source reports.

```APIDOC
## POST /mcp/v1

### Description
Performs internet-scale plagiarism scans on provided text and returns detailed source reports.

### Method
POST

### Endpoint
https://api.gowinston.ai/mcp/v1

### Parameters
#### Request Body
- **jsonrpc** (string) - Required - The JSON-RPC protocol version, should be "2.0".
- **id** (integer) - Required - A unique identifier for the request.
- **method** (string) - Required - The method to call, should be "tools/call".
- **params** (object) - Required - Parameters for the tool call.
  - **name** (string) - Required - The name of the tool, should be "plagiarism-detection".
  - **arguments** (object) - Required - Arguments for the "plagiarism-detection" tool.
    - **text** (string) - Required - The text to check for plagiarism (minimum 100 characters).
    - **apiKey** (string) - Required - Your Winston AI API key.
```

--------------------------------

### API Response Schema

Source: https://docs.gowinston.ai/api-reference/v2/ai-content-detection/post

Details regarding the standard fields returned in API responses.

```APIDOC
## API Response Fields

### Description
Standard fields returned in the response body after a successful request.

### Parameters
- **credits_remaining** (integer) - The number of credits remaining in the account after the request is processed.
- **version** (string) - The model version used to generate the prediction.
- **language** (string) - The detected language of the text (en, fr, es, pt, nl, de, pl, it, ro, id, tl, ru, bg, zh).
```

--------------------------------

### Image Metadata Fields

Source: https://docs.gowinston.ai/api-reference/v2/image-detection/post

This section outlines the various metadata fields available for images, categorized for clarity.

```APIDOC
## Image Metadata Fields

This section details the available metadata fields for images.

### Data Mining

- **Data mining prohibition or permission**: Allows specifying data mining restrictions.

### Artwork Metadata

- **Artwork** (string): A set of metadata about artwork or an object in the image.

### Registration Information

- **ImageRegistryEntry** (string): Both a Registry Item Id and a Registry Organisation Id to record any registration of this digital image with a registry.

### Geographical Information

- **City** (string): Name of the city of the location shown in the image. This element is at the third level of a top-down geographical hierarchy.
- **Country** (string): Full name of the country of the location shown in the image. This element is at the top/first level of a top-down geographical hierarchy. The full name should be expressed as a verbal name and not as a code, a code should go to the element CountryCode.

### Organization and Event Information

- **CodeofOrganisationFeaturedintheImage** (string): Code from a controlled vocabulary for identifying the organisation or company which is featured in the image.
- **NameofOrganisationFeaturedintheImage** (string): Name of the organisation or company which is featured in the image.
- **EventIdentifier** (string): Identifier(s) of the specific event at which the photo was taken.
- **EventName** (string): Names or describes the specific event at which the photo was taken.

### Contributor and Copyright Information

- **Contributor** (string): Party or parties (person or organisation) which contributed to the image, refinement by the role attribute.
- **CopyrightOwner** (string): Owner or owners of the copyright in the licensed image.

### Image Source and Identification

- **DigitalSourceType** (string): Name of the organisation or company which is featured in the image.
- **Source** (string): The name of a person or party who has a role in the content supply chain. This could be an agency, a member of an agency, an individual or a combination. Source could be different from Creator and from the entities in the Copyright Notice.
- **DigitalImageGUID** (string): Globally unique identifier for this digital image. It is created and applied by the creator of the digital image at the time of its creation. This value shall not be changed after that time.
- **Licensor** (string): A person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

### Release and Licensing Information

- **PropertyReleaseId** (string): Identifier(s) of a Property Release document.
- **PropertyReleaseStatus** (string): Summarises the availability and scope of property releases authorising usage of the properties appearing in the photograph.

### Content Description

- **keywords** (array of strings): Keywords to express the subject of the image. Keywords may be free text and don't have to be taken from a controlled vocabulary. Codes from the controlled vocabulary IPTC Subject NewsCodes must go to the Subject Code field.

### Creator and Instructions

- **ImageCreator** (object): Creator or creators of the image.
- **Instructions** (string): Any number of instructions from the provider or creator to the receiver of the image.

### Title

- **Title** (string): A shorthand reference for the digital image. Title provides a short human readable name which can be a text and/or numeric reference. It is not the same as Headline.

### Technical Metadata

- **metadata** (object): Image metadata including dimensions, format, color space, and other technical details.
  - **orientation** (integer): Orientation of the image.
```

--------------------------------

### Image Metadata Schema

Source: https://docs.gowinston.ai/api-reference/v2/image-detection/post

Describes the structure of the image metadata object returned by the system.

```APIDOC
## Image Metadata Object

### Description
Represents the metadata extracted from an image, including technical specifications like dimensions, color space, and format-specific details.

### Response Fields
- **format** (string) - Name of decoder used to decompress image data (e.g., jpeg, png, webp, gif, svg)
- **size** (integer) - Total size of image in bytes (for Stream and Buffer input only)
- **width** (integer) - Number of pixels wide (EXIF orientation not considered)
- **height** (integer) - Number of pixels high (EXIF orientation not considered)
- **autoOrient** (object) - Metadata after image orientation is applied
  - **width** (integer) - Number of pixels wide (EXIF orientation considered)
  - **height** (integer) - Number of pixels high (EXIF orientation considered)
- **space** (string) - Name of colour space interpretation
- **channels** (integer) - Number of bands (e.g., 3 for sRGB, 4 for CMYK)
- **depth** (string) - Name of pixel depth format (e.g., uchar, char, ushort, float)
- **density** (number) - Number of pixels per inch (DPI), if present
- **chromaSubsampling** (string) - JPEG chroma subsampling (e.g., 4:2:0, 4:4:4)
- **isProgressive** (boolean) - Indicates if the image is interlaced using a progressive scan
- **isPalette** (boolean) - Indicates if the image is palette-based (GIF, PNG)
- **bitsPerSample** (integer) - Number of bits per sample for each channel (GIF, PNG)
- **pages** (integer) - Number of pages/frames (TIFF, HEIF, PDF, animated GIF/WebP)
- **pageHeight** (integer) - Height of each page in a multi-page image
- **loop** (integer) - Number of times to loop an animated image
- **delay** (array) - Delay in ms between each page in an animated image
- **pagePrimary** (integer) - Number of the primary page in a HEIF image
- **hasProfile** (boolean) - Indicates presence of an embedded ICC profile
- **hasAlpha** (boolean) - Indicates presence of an alpha transparency channel
- **background** (object) - Default background colour for PNG (bKGD) and GIF images
- **levels** (array) - Details of each level in a multi-level image
- **subifds** (integer) - Number of Sub Image File Directories in an OME-TIFF image
- **resolutionUnit** (string) - Unit of resolution
```

--------------------------------

### MCP Server JSON-RPC 2.0 Request Structure

Source: https://docs.gowinston.ai/api-reference/mcp-server

The required structure for all requests to the MCP server. Ensure 'jsonrpc', 'method', 'id', and 'params' are correctly formatted.

```json
{
  "jsonrpc": "2.0",      // protocol version
  "method": "…",         // tools/list or tools/call
  "id": 1,                // correlation id
  "params": { … }         // depends on the method
}
```

--------------------------------

### Image Properties and AI Watermark Detection

Source: https://docs.gowinston.ai/api-reference/v2/image-detection/post

This section details the properties of processed images, including format, dimensions, and AI watermark detection results.

```APIDOC
## Image Processing API Details

### Description
This API processes images and provides detailed information about the image properties, including format, dimensions, color space, and whether an AI watermark was detected.

### Response (Success)

#### Response Body Fields
- **format** (string) - The unit of resolution (density).
- **formatMagick** (string) - String containing format for images loaded via *magick.
- **comments** (array) - Array of keyword/text pairs representing PNG text blocks, if present.
  - **items** (object)
    - **type** (string)
    - **description** (string)
- **ai_watermark_detected** (boolean) - Whether an AI watermark was detected in the image.
- **ai_watermark_issuers** (object) - The list of AI watermark issuers detected in the image.
- **credits_used** (integer) - The number of credits consumed for processing your request. Each image processed consumes 300 credits.
- **credits_remaining** (integer) - The number of credits remaining in your account after your request has been processed.

### Security
- **bearerAuth** (http) - Scheme: bearer
```

--------------------------------

### AI Image Detection via cURL

Source: https://docs.gowinston.ai/api-reference/mcp-server

Detect AI-generated images by providing the image URL and your API key. This method analyzes image content and metadata.

```bash
curl --location 'https://api.gowinston.ai/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json' \
--data '{ 
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "ai-image-detection",
    "arguments": {
      "url": "https://example.com/image.jpg",
      "apiKey": "your-winston-ai-api-key"
    }
  }
}'
```

--------------------------------

### POST /v2/text-compare Endpoint Specification

Source: https://docs.gowinston.ai/api-reference/v2/text-compare/post

This OpenAPI definition describes the POST /v2/text-compare endpoint for comparing two texts. It includes request body schema, response schemas for success and various error conditions (400, 401, 402, 403, 429, 500).

```yaml
openapi: 3.0.1
info:
  title: Winston AI API
  description: Winston AI API specification
  license:
    name: MIT
  version: 4.11.4
servers:
  - url: https://api.gowinston.ai/
security:
  - bearerAuth: []
paths:
  /v2/text-compare:
    post:
      description: >-
        Compare two texts to find similarities and differences between them.
        This endpoint analyzes both texts and returns detailed information about
        matching content, word counts, and similarity scores.
      requestBody:
        description: The text comparison request body
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TextCompare'
        required: true
      responses:
        '200':
          description: Text comparison response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TextCompare-response'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: BAD_REQUEST
                  description:
                    type: string
                    default: >-
                      The request was invalid and could not be processed. Make
                      sure you pass valid arguments.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: UNAUTHORIZED
                  description:
                    type: string
                    default: >-
                      Pass a valid API key in the Authorization header as a
                      Bearer token.
        '402':
          description: Payment Required (insufficient credits)
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: PAYMENT_REQUIRED
                  description:
                    type: string
                    default: >-
                      Insufficient credits. Make sure you have enough credits to
                      make the request.
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: FORBIDDEN
                  description:
                    type: string
                    default: >-
                      The request was forbidden. Make sure you pass a valid URL
                      or document that we can access.
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: TOO_MANY_REQUESTS
                  description:
                    type: string
                    default: You have exceeded the rate limit. Please try again later.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    default: INTERNAL_SERVER_ERROR
                  description:
                    type: string
                    default: An unexpected error occurred. Please try again later.
components:
  schemas:
    TextCompare:
      required:
        - first_text
        - second_text
      type: object
      properties:
        first_text:
          description: The first text to compare. Maximum 120,000 characters.
          type: string
          maxLength: 120000
        second_text:
          description: >-
            The second text to compare against the first text. Maximum 120,000
            characters.
          type: string
          maxLength: 120000
    TextCompare-response:
      type: object
      properties:
        status:
          type: integer
          description: >-
            HTTP status code representing the result of the text comparison
            request
        similarity_score:
          type: number
          description: |-
            Overall similarity score between the two texts (0-100).

             0 means no similarity, 100 means identical.
        first_text:
          type: object
          properties:
            total_word_count:
              type: integer
              description: Total number of words in the first text

```

--------------------------------

### MCP Server API - AI Text Detection

Source: https://docs.gowinston.ai/api-reference/mcp-server

Detects whether text is human-written or AI-generated, providing sentence-level analysis.

```APIDOC
## POST /mcp/v1

### Description
Performs AI text detection to classify text as human-written or AI-generated, including sentence-level analysis.

### Method
POST

### Endpoint
https://api.gowinston.ai/mcp/v1

### Parameters
#### Request Body
- **jsonrpc** (string) - Required - The JSON-RPC protocol version, should be "2.0".
- **id** (integer) - Required - A unique identifier for the request.
- **method** (string) - Required - The method to call, should be "tools/call".
- **params** (object) - Required - Parameters for the tool call.
  - **name** (string) - Required - The name of the tool, should be "ai-text-detection".
  - **arguments** (object) - Required - Arguments for the "ai-text-detection" tool.
    - **text** (string) - Required - The text to analyze (minimum 300 characters).
    - **apiKey** (string) - Required - Your Winston AI API key.
```

--------------------------------

### POST /v2/plagiarism

Source: https://docs.gowinston.ai/api-reference/v2/plagiarism/post

Checks provided text for plagiarism by comparing it against content found on the internet.

```APIDOC
## POST /v2/plagiarism

### Description
Winston AI's plagiarism API is a powerful tool designed to check text for plagiarism by scouring the internet for similar content. It queries multiple websites and compares the input text with the content found on these websites. This can be particularly useful in academic settings, content creation, legal scenarios or any other situation where originality of content is required.

### Method
POST

### Endpoint
https://api.gowinston.ai/v2/plagiarism

### Request Body
- **document** (string) - Required - The text content to check for plagiarism.
- **url** (string) - Optional - A URL to check for plagiarism.
- **language** (string) - Optional - The language of the document. Defaults to 'en'.
- **min_score** (number) - Optional - The minimum similarity score to consider as plagiarism. Defaults to 0.5.
- **max_retries** (integer) - Optional - The maximum number of retries for fetching external resources. Defaults to 3.
- **callback_url** (string) - Optional - A URL to send the results to when the process is complete.

### Request Example
```json
{
  "document": "This is a sample text to check for plagiarism.",
  "language": "en",
  "min_score": 0.6
}
```

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the plagiarism check.
- **status** (string) - The current status of the plagiarism check (e.g., 'processing', 'completed', 'failed').
- **results** (object) - An object containing the plagiarism results when the status is 'completed'.
  - **score** (number) - The overall plagiarism score.
  - **matches** (array) - A list of matching sources.
    - **url** (string) - The URL of the source.
    - **score** (number) - The similarity score for this source.
    - **title** (string) - The title of the source.

#### Error Response (400)
- **error** (string) - 'BAD_REQUEST'
- **description** (string) - 'The request was invalid and could not be processed. Make sure you pass valid arguments.'

#### Error Response (401)
- **error** (string) - 'UNAUTHORIZED'
- **description** (string) - 'Pass a valid API key in the Authorization header as a Bearer token.'

#### Error Response (402)
- **error** (string) - 'PAYMENT_REQUIRED'
- **description** (string) - 'Insufficient credits. Make sure you have enough credits to make the request.'

#### Error Response (403)
- **error** (string) - 'FORBIDDEN'
- **description** (string) - 'The request was forbidden. Make sure you pass a valid URL or document that we can access.'

#### Error Response (415)
- **error** (string) - 'UNSUPPORTED_MEDIA_TYPE'
- **description** (string) - 'The request content type is not supported. Make sure you pass a valid content type.'

#### Error Response (429)
- **error** (string) - 'TOO_MANY_REQUESTS'
- **description** (string) - 'You have exceeded the rate limit. Please try again later.'

#### Error Response (500)
- **error** (string) - 'INTERNAL_SERVER_ERROR'
- **description** (string) - 'An unexpected error occurred. Please try again later.'

#### Error Response (503)
- **error** (string) - 'SERVICE_UNAVAILABLE'
- **description** (string) - 'Service is temporarily unavailable. Please try again later.'
```

--------------------------------

### POST /v2/image-detection

Source: https://docs.gowinston.ai/api-reference/v2/image-detection/post

Detects if an image is AI-generated by analyzing its metadata and using a machine learning model.

```APIDOC
## POST /v2/image-detection

### Description
Our image detection feature enables AI-generated image detection by verifying image metadata and using a machine learning system trained to differentiate between human and AI-generated images.

### Method
POST

### Endpoint
https://api.gowinston.ai/v2/image-detection

### Parameters
#### Request Body
- **url** (string) - Required - The URL of the image to be analyzed.

### Request Example
```json
{
  "url": "https://example.com/image.jpg"
}
```

### Response
#### Success Response (200)
- **is_ai_generated** (boolean) - Indicates whether the image is detected as AI-generated.
- **confidence_score** (number) - The confidence score of the detection.
- **moderation_status** (string) - The moderation status of the image.

#### Response Example
```json
{
  "is_ai_generated": true,
  "confidence_score": 0.95,
  "moderation_status": "flagged"
}
```

### Error Handling
- **400 Bad Request**: The request was invalid and could not be processed. Make sure you pass valid arguments.
- **401 Unauthorized**: Pass a valid API key in the Authorization header as a Bearer token.
- **402 Payment Required**: Insufficient credits. Make sure you have enough credits to make the request.
- **403 Forbidden**: The request was forbidden. Make sure you pass a valid URL or document that we can access.
- **415 Unsupported Media Type**: The request content type is not supported. Make sure you pass a valid content type.
- **429 Too Many Requests**: You have exceeded the rate limit. Please try again later.
- **500 Internal Server Error**: An unexpected error occurred. Please try again later.
- **503 Service Unavailable**: The service is currently unavailable. Please try again later.
```
Tokens:
Raw