Microsoft Azure

Microsoft Azure Translate API

The Translate API from Microsoft Azure — 1 operation(s) for translate.

Documentation GitHub OpenAPI

Operations 1

POST /translate Microsoft Azure Translate Text #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/microsoft-azure-translate-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Translate API
tags:
- name: Translate
paths:
  /translate:
    post:
      operationId: microsoftAzureTranslate
      summary: Microsoft Azure Translate Text
      description: Translate Text
      parameters:
      - name: X-ClientTraceId
        in: header
        description: A client-generated GUID to uniquely identify the request.
        required: false
        x-ms-client-name: clientTraceId
        schema:
          type: string
      - $ref: '#/components/parameters/TranslateParameters.to'
      - $ref: '#/components/parameters/TranslateParameters.from'
      - $ref: '#/components/parameters/TranslateParameters.textType'
      - $ref: '#/components/parameters/TranslateParameters.category'
      - $ref: '#/components/parameters/TranslateParameters.profanityAction'
      - $ref: '#/components/parameters/TranslateParameters.profanityMarker'
      - $ref: '#/components/parameters/TranslateParameters.includeAlignment'
      - $ref: '#/components/parameters/TranslateParameters.includeSentenceLength'
      - $ref: '#/components/parameters/TranslateParameters.suggestedFrom'
      - $ref: '#/components/parameters/TranslateParameters.fromScript'
      - $ref: '#/components/parameters/TranslateParameters.toScript'
      - $ref: '#/components/parameters/TranslateParameters.allowFallback'
      - name: api-version
        in: query
        description: Mandatory API version parameter
        required: true
        x-ms-client-name: apiVersion
        schema:
          type: string
      responses:
        '200':
          description: Response for the translation API.
          headers:
            X-RequestId:
              description: Value generated by the service to identify the request. It is used for troubleshooting purposes.
              schema:
                type: string
            x-metered-usage:
              description: "Specifies consumption (the number of characters for which the user will be charged) for the translation \njob request. For example, if the word \"Hello\" is translated from English (en) to French (fr), \nthis field will return the value '5'."
              schema:
                type: integer
                format: int32
            x-mt-system:
              description: "Specifies the system type that was used for translation for each 'to' language requested for translation. \nThe value is a comma-separated list of strings. Each string indicates a type:\n\n* Custom - Request includes a custom system and at least one custom system was used during translation.\n* Team - All other requests"
              schema:
                type: string
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TranslatedTextItem'
                x-ms-identifiers: []
        default:
          description: An unexpected error response.
          headers:
            X-RequestId:
              description: Value generated by the service to identify the request. It is used for troubleshooting purposes.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        Translate Text:
          $ref: ./examples/Translate_MaximumSet_Gen.json
        Translate Text with minimum properties:
          $ref: ./examples/Translate_MinimumSet_Gen.json
      tags:
      - Translate
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/InputTextItem'
              x-ms-identifiers: []
        description: Defines the content of the request
        required: true
components:
  schemas:
    InputTextItem:
      type: object
      description: Element containing the text for translation.
      properties:
        text:
          type: string
          description: Text to translate.
      required:
      - text
    Translation:
      type: object
      description: Translation result
      properties:
        to:
          type: string
          description: A string representing the language code of the target language.
        text:
          type: string
          description: A string giving the translated text.
        transliteration:
          $ref: '#/components/schemas/TransliteratedText'
          description: An object giving the translated text in the script specified by the toScript parameter.
        alignment:
          $ref: '#/components/schemas/TranslatedTextAlignment'
          description: Alignment information.
        sentLen:
          $ref: '#/components/schemas/SentenceLength'
          description: Sentence boundaries in the input and output texts.
      required:
      - to
      - text
    SourceText:
      type: object
      description: 'Input text in the default script of the source language. '
      properties:
        text:
          type: string
          description: Input text in the default script of the source language.
      required:
      - text
    TransliteratedText:
      type: object
      description: Transliterated text element.
      properties:
        text:
          type: string
          description: A string which is the result of converting the input string to the output script.
        script:
          type: string
          description: A string specifying the script used in the output.
      required:
      - text
      - script
    TranslatedTextAlignment:
      type: object
      description: Alignment information object.
      properties:
        proj:
          type: string
          description: "Maps input text to translated text. The alignment information is only provided when the request \nparameter includeAlignment is true. Alignment is returned as a string value of the following \nformat: [[SourceTextStartIndex]:[SourceTextEndIndex]–[TgtTextStartIndex]:[TgtTextEndIndex]]. \nThe colon separates start and end index, the dash separates the languages, and space separates the words. \nOne word may align with zero, one, or multiple words in the other language, and the aligned words may \nbe non-contiguous. When no alignment information is available, the alignment element will be empty."
      required:
      - proj
    SentenceLength:
      type: object
      description: An object returning sentence boundaries in the input and output texts.
      properties:
        srcSentLen:
          type: array
          description: "An integer array representing the lengths of the sentences in the input text. \nThe length of the array is the number of sentences, and the values are the length of each sentence."
          items:
            type: integer
            format: int32
        transSentLen:
          type: array
          description: "An integer array representing the lengths of the sentences in the translated text. \nThe length of the array is the number of sentences, and the values are the length of each sentence."
          items:
            type: integer
            format: int32
      required:
      - srcSentLen
      - transSentLen
    ErrorDetails:
      type: object
      description: Error details as returned by Translator Service.
      properties:
        code:
          type: integer
          format: int32
          description: Number identifier of the error.
        message:
          type: string
          description: Human readable error description.
      required:
      - code
      - message
    ErrorResponse:
      type: object
      description: Representation of the Error Response from Translator Service.
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetails'
          description: Error details.
      required:
      - error
    TranslatedTextItem:
      type: object
      description: Element containing the translated text
      properties:
        detectedLanguage:
          $ref: '#/components/schemas/DetectedLanguage'
          description: The detectedLanguage property is only present in the result object when language auto-detection is requested.
        translations:
          type: array
          description: "An array of translation results. The size of the array matches the number of target \nlanguages specified through the to query parameter."
          items:
            $ref: '#/components/schemas/Translation'
          x-ms-identifiers: []
        sourceText:
          $ref: '#/components/schemas/SourceText'
          description: "Input text in the default script of the source language. sourceText property is present only when \nthe input is expressed in a script that's not the usual script for the language. For example, \nif the input were Arabic written in Latin script, then sourceText.text would be the same Arabic text \nconverted into Arab script."
      required:
      - translations
    DetectedLanguage:
      type: object
      description: An object describing the detected language.
      properties:
        language:
          type: string
          description: A string representing the code of the detected language.
        score:
          type: number
          format: float
          description: 'A float value indicating the confidence in the result.

            The score is between zero and one and a low score indicates a low confidence.'
      required:
      - language
      - score
  parameters:
    TranslateParameters.textType:
      name: textType
      in: query
      description: "Defines whether the text being translated is plain text or HTML text. Any HTML needs to be a well-formed, \ncomplete element. Possible values are: plain (default) or html."
      required: false
      x-ms-enum:
        name: TextType
        modelAsString: true
        values:
        - name: Plain
          value: Plain
        - name: Html
          value: Html
      x-ms-parameter-location: method
      schema:
        type: string
        enum:
        - Plain
        - Html
        default: Plain
    TranslateParameters.fromScript:
      name: fromScript
      in: query
      description: Specifies the script of the input text.
      required: false
      x-ms-parameter-location: method
      schema:
        type: string
    TranslateParameters.includeAlignment:
      name: includeAlignment
      in: query
      description: 'Specifies whether to include alignment projection from source text to translated text.

        Possible values are: true or false (default).'
      required: false
      x-ms-parameter-location: method
      schema:
        type: boolean
        default: false
    TranslateParameters.from:
      name: from
      in: query
      description: "Specifies the language of the input text. Find which languages are available to translate from by \nlooking up supported languages using the translation scope. If the from parameter isn't specified, \nautomatic language detection is applied to determine the source language.\n\nYou must use the from parameter rather than autodetection when using the dynamic dictionary feature. \nNote: the dynamic dictionary feature is case-sensitive."
      required: false
      x-ms-parameter-location: method
      schema:
        type: string
    TranslateParameters.to:
      name: to
      in: query
      description: "Specifies the language of the output text. The target language must be one of the supported languages included \nin the translation scope. For example, use to=de to translate to German.\nIt's possible to translate to multiple languages simultaneously by repeating the parameter in the query string. \nFor example, use to=de&to=it to translate to German and Italian."
      required: true
      x-ms-parameter-location: method
      style: form
      explode: true
      schema:
        type: array
        items:
          type: string
    TranslateParameters.toScript:
      name: toScript
      in: query
      description: Specifies the script of the translated text.
      required: false
      x-ms-parameter-location: method
      schema:
        type: string
    TranslateParameters.suggestedFrom:
      name: suggestedFrom
      in: query
      description: "Specifies a fallback language if the language of the input text can't be identified. \nLanguage autodetection is applied when the from parameter is omitted. If detection fails, \nthe suggestedFrom language will be assumed."
      required: false
      x-ms-parameter-location: method
      schema:
        type: string
    TranslateParameters.profanityAction:
      name: profanityAction
      in: query
      description: 'Specifies how profanities should be treated in translations.

        Possible values are: NoAction (default), Marked or Deleted.'
      required: false
      x-ms-enum:
        name: ProfanityAction
        modelAsString: true
        values:
        - name: NoAction
          value: NoAction
        - name: Marked
          value: Marked
        - name: Deleted
          value: Deleted
      x-ms-parameter-location: method
      schema:
        type: string
        enum:
        - NoAction
        - Marked
        - Deleted
        default: NoAction
    TranslateParameters.allowFallback:
      name: allowFallback
      in: query
      description: "Specifies that the service is allowed to fall back to a general system when a custom system doesn't exist. \nPossible values are: true (default) or false.\n\nallowFallback=false specifies that the translation should only use systems trained for the category specified \nby the request. If a translation for language X to language Y requires chaining through a pivot language E, \nthen all the systems in the chain (X → E and E → Y) will need to be custom and have the same category. \nIf no system is found with the specific category, the request will return a 400 status code. allowFallback=true \nspecifies that the service is allowed to fall back to a general system when a custom system doesn't exist."
      required: false
      x-ms-parameter-location: method
      schema:
        type: boolean
        default: true
    TranslateParameters.category:
      name: category
      in: query
      description: "A string specifying the category (domain) of the translation. This parameter is used to get translations \nfrom a customized system built with Custom Translator. Add the Category ID from your Custom Translator \nproject details to this parameter to use your deployed customized system. Default value is: general."
      required: false
      x-ms-parameter-location: method
      schema:
        type: string
        default: general
    TranslateParameters.includeSentenceLength:
      name: includeSentenceLength
      in: query
      description: 'Specifies whether to include sentence boundaries for the input text and the translated text.

        Possible values are: true or false (default).'
      required: false
      x-ms-parameter-location: method
      schema:
        type: boolean
        default: false
    TranslateParameters.profanityMarker:
      name: profanityMarker
      in: query
      description: 'Specifies how profanities should be marked in translations.

        Possible values are: Asterisk (default) or Tag. '
      required: false
      x-ms-enum:
        name: ProfanityMarker
        modelAsString: true
        values:
        - name: Asterisk
          value: Asterisk
        - name: Tag
          value: Tag
      x-ms-parameter-location: method
      schema:
        type: string
        enum:
        - Asterisk
        - Tag
        default: Asterisk
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/components/parameters/Endpoint'