openapi: 3.1.0
info:
  title: Translate to English API
  description: >
    This API translates text from various languages into English using advanced translation algorithms and AI models.

    To use this API, you need an API key. Register for an API key at [Interzoid Registration](https://www.interzoid.com/register-api-account).

    For more information about this API, visit the [Translate to English API Documentation](https://www.interzoid.com/apis/translate-to-english).

    You can also try this API [interactively](https://try.interzoid.com) or in high-speed [batch mode](https://batch.interzoid.com).
  version: 1.0.0
  contact:
    name: Interzoid Support
    url: https://www.interzoid.com
    email: support@interzoid.com
externalDocs:
  description: API home page and documentation
  url: https://www.interzoid.com/apis/translate-to-english
servers:
  - url: https://api.interzoid.com
    description: Production server
tags:
  - name: Text Translation
    description: Translates text from various languages into English.
paths:
  /translatetoenglish:
    get:
      operationId: translateToEnglish
      tags:
        - Text Translation
      summary: Translate Text to English
      description: >
        Translates the provided text into English. Include your API key (license) in the request. Register for an API key at https://www.interzoid.com/register-api-account.
      parameters:
        - name: license
          in: query
          required: true
          description: >
            Your API license key. Register for an API key at
            [Interzoid Registration](https://www.interzoid.com/register-api-account).
          schema:
            type: string
          examples:
            license:
              summary: API Key Example
              value: "fh5hs7*****"
        - name: text
          in: query
          required: true
          description: The text to be translated into English.
          schema:
            type: string
          examples:
            text:
              summary: Text Example
              value: "Parigi"
      responses:
        '200':
          description: Successful response containing the translated text.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Result:
                    type: string
                    description: The translated text in English.
                  Credits:
                    type: integer
                    description: Remaining credits for your API license.
                  Code:
                    type: string
                    description: Response code, "Success" if the call is successful.
              examples:
                success:
                  value:
                    Result: "Paris"
                    Credits: 16462
                    Code: "Success"
        '400':
          description: Bad request (e.g., missing or invalid parameters).
          content:
            text/plain:
              schema:
                type: string
              examples:
                error:
                  value: "Invalid license key or text missing."
        '402':
          description: API key not found.
          content:
            text/plain:
              schema:
                type: string
              examples:
                error:
                  value: "API key not found."
        '403':
          description: Insufficient API credits remaining.
          content:
            text/plain:
              schema:
                type: string
              examples:
                error:
                  value: "Insufficient API credits remaining."
        '405':
          description: Method not allowed.
          content:
            text/plain:
              schema:
                type: string
              examples:
                error:
                  value: "Method not allowed."
        '429':
          description: Rate limits reached.
          content:
            text/plain:
              schema:
                type: string
              examples:
                error:
                  value: "Rate limits reached."
        '500':
          description: Internal server error.
          content:
            text/plain:
              schema:
                type: string
              examples:
                error:
                  value: "Internal server error."
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      name: license
      in: query
  schemas: {}
security:
  - apiKeyAuth: []