# Translator Text Client API

> Translator Text Client API on Apizie: 7 endpoints (Identifies the position of sentence boundaries in a piece of text., Identifies the language of a string of text., Provides alternative translations for a word and a small number of idiomatic phrases. Each translation has a…, Provides examples that show how terms in the dictionary are used in context. This operation is used in…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:azure-cognitiveservices-translator-text/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:azure-cognitiveservices-translator-text`
- Category: Cloud
- Status: byok
- Source: https://learn.microsoft.com/rest/api/azure/
- Page: https://apizie.tech/api/cloud/azure-cognitiveservices-translator-text
- OpenAPI: https://apizie.tech/api/cloud/azure-cognitiveservices-translator-text/openapi.json

# Introduction The Microsoft Translator Text API provides a JSON-based Web API. It provides: * Translation between any supported languages to any other supported language. * Translation to multiple languages in one…

## Endpoints

### Identifies the position of sentence boundaries in a piece of text.
`POST https://apizie.tech/v1/cloud:azure-cognitiveservices-translator-text/translator-break-sentence` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Endpoint | string | yes | Supported Cognitive Services endpoints |
| api-version | string | no | Version of the API requested by the client. Value must be **3.0**. |
| Language | string | no | Language tag of the language of the input text. If not specified, Translator will apply automatic language detection. |
| Script | string | no | Script identifier of the script used by the input text. If a script is not specified, the default script of the language will be assumed. |
| X-ClientTraceId | string | no | A client-generated GUID to uniquely identify the request. Note that you can omit this header if you include the trace ID in the query… |
| body | object | yes | JSON request body |

### Identifies the language of a string of text.
`POST https://apizie.tech/v1/cloud:azure-cognitiveservices-translator-text/translator-detect` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Endpoint | string | yes | Supported Cognitive Services endpoints |
| api-version | string | no | Version of the API requested by the client. Value must be **3.0**. |
| X-ClientTraceId | string | no | A client-generated GUID to uniquely identify the request. Note that you can omit this header if you include the trace ID in the query… |
| body | object | yes | JSON request body |

### Provides alternative translations for a word and a small number of idiomatic phrases. Each translation has a…
`POST https://apizie.tech/v1/cloud:azure-cognitiveservices-translator-text/translator-dictionary-lookup` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Endpoint | string | yes | Supported Cognitive Services endpoints |
| api-version | string | no | Version of the API requested by the client. Value must be **3.0**. |
| from | string | yes | Specifies the language of the input text. The source language must be one of the supported languages included in the `dictionary` scope. |
| to | string | yes | Specifies the language of the output text. The target language must be one of the supported languages included in the `dictionary` scope… |
| X-ClientTraceId | string | no | A client-generated GUID to uniquely identify the request. Note that you can omit this header if you include the trace ID in the query… |
| body | object | yes | JSON request body |

### Provides examples that show how terms in the dictionary are used in context. This operation is used in…
`POST https://apizie.tech/v1/cloud:azure-cognitiveservices-translator-text/translator-dictionary-examples` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Endpoint | string | yes | Supported Cognitive Services endpoints |
| api-version | string | no | Version of the API requested by the client. Value must be **3.0**. |
| from | string | yes | Specifies the language of the input text. The source language must be one of the supported languages included in the `dictionary` scope. |
| to | string | yes | Specifies the language of the output text. The target language must be one of the supported languages included in the `dictionary` scope. |
| X-ClientTraceId | string | no | A client-generated GUID to uniquely identify the request. Note that you can omit this header if you include the trace ID in the query… |
| body | object | yes | JSON request body |

### Gets the set of languages currently supported by other operations of the Translator Text API.…
`GET https://apizie.tech/v1/cloud:azure-cognitiveservices-translator-text/translator-languages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Endpoint | string | yes | Supported Cognitive Services endpoints |
| api-version | string | no | Version of the API requested by the client. Value must be **3.0**. |
| scope | array | no | A comma-separated list of names defining the group of languages to return. Allowed group names are- `translation`, `transliteration` and… |
| Accept-Language | string | no | The language to use for user interface strings. Some of the fields in the response are names of languages or names of regions. Use this… |
| X-ClientTraceId | string | no | A client-generated GUID to uniquely identify the request. Note that you can omit this header if you include the trace ID in the query… |

### Translates text into one or more languages.
`POST https://apizie.tech/v1/cloud:azure-cognitiveservices-translator-text/translator-translate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Endpoint | string | yes | Supported Cognitive Services endpoints |
| api-version | string | no | Version of the API requested by the client. Value must be **3.0**. |
| from | string | no | Specifies the language of the input text. Find which languages are available to translate from by using the languages method. If the… |
| to | array | yes | Specifies the language of the output text. Find which languages are available to translate to by using the languages method. For example,… |
| textType | string | no | Defines whether the text being translated is plain text or HTML text. Any HTML needs to be a well-formed, complete HTML element. Possible… |
| category | string | no | A string specifying the category (domain) of the translation. This parameter retrieves translations from a customized system built with… |
| profanityAction | string | no | Specifies how profanities should be treated in translations. Possible values are: `NoAction` (default), `Marked` or `Deleted`. ###… |
| profanityMarker | string | no | Specifies how profanities should be marked in translations. Possible values are- `Asterisk` (default) or `Tag`. |
| includeAlignment | boolean | no | Specifies whether to include alignment projection from source text to translated text. Possible values are- `true` or `false` (default). |
| includeSentenceLength | boolean | no | Specifies whether to include sentence boundaries for the input text and the translated text. Possible values are- `true` or `false`… |
| suggestedFrom | string | no | Specifies a fallback language if the language of the input text can't be identified. Language auto-detection is applied when the `from`… |
| fromScript | string | no | Specifies the script of the input text. Supported scripts are available from the languages method |
| toScript | array | no | Specifies the script of the translated text. Supported scripts are available from the languages method |
| X-ClientTraceId | string | no | A client-generated GUID to uniquely identify the request. Note that you can omit this header if you include the trace ID in the query… |
| body | object | yes | JSON request body |

### Converts the text of a language in one script into another type of script. Example- Japanese script "こんにちは"…
`POST https://apizie.tech/v1/cloud:azure-cognitiveservices-translator-text/translator-transliterate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Endpoint | string | yes | Supported Cognitive Services endpoints |
| api-version | string | no | Version of the API requested by the client. Value must be **3.0**. |
| language | string | yes | Specifies the language of the text to convert from one script to another. Possible languages are listed in the `transliteration` scope… |
| fromScript | string | yes | Specifies the script used by the input text. Lookup supported languages using the `transliteration` scope, to find input scripts available… |
| toScript | string | yes | Specifies the output script. Lookup supported languages using the `transliteration` scope, to find output scripts available for the… |
| X-ClientTraceId | string | no | A client-generated GUID to uniquely identify the request. Note that you can omit this header if you include the trace ID in the query… |
| body | object | yes | JSON request body |

## Example
```
curl "https://apizie.tech/v1/cloud:azure-cognitiveservices-translator-text/translator-break-sentence" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Translator Text Client API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:azure-cognitiveservices-translator-text/translator-break-sentence with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Translator Text Client API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Translator Text Client itself also needs your own key from azure.com.

### Can AI agents use the Translator Text Client API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:azure-cognitiveservices-translator-text.

### What is the status of the Translator Text Client API?
Needs your own provider key (bring your own key)