---
title: Translate Text API
slug: translate-text
url: https://apyhub.com/sharpapi/service/translate-text
provider: SharpAPI
categories: [Model Kit]
tags: [content, link, seo, job]
auth: api_key
version: 1.0.0
service_type: job
endpoints: 2
atoms: 1-50
mcp: true
alias: sharpapi-translate-text
---

# Translate Text API

Submit text with optional context, source language, and tone of voice. Track the job and collect translated content with from and to metadata.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/sharpapi/translate-text` | What it does Submits a text translation job using the supplied content and optional translation gui… | 50 |
| GET | `https://api.eu.apyhub.com/sharpapi/translate-text/job/status/:job_id` | What it does Checks the status of a previously submitted text-translation job identified by jobid.… | 1 |

## Endpoint reference

### Translate Text Submit Job

`POST https://api.eu.apyhub.com/sharpapi/translate-text` · 50 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `content` | body | string | yes | Provide the content to translate. Example: `Sample value`. |
| `context` | body | string | no | Provide additional context to the translated text, such as use case examples or additional explanations. Example: `Sample value`. |
| `language` | body | string | no | Specify the language of the content which needs to be translated.(For example: 'German'). Example: `Sample value`. |
| `voice_tone` | body | string | no | Specify the voice tone of the output. It can be adjectives like funny or joyous, or even the name of a famous writer. Example: `Sample value`. |

#### Quickstart

Send the text you want translated in a JSON body to start a translation job.

```bash
curl -X POST "https://api.eu.apyhub.com/sharpapi/translate-text" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello, how are you?"
  }'
```

#### What you'll get back

Returns a JSON object with a required `job_id` string field identifying the translation job.

```json
{
  "job_id": "7a37675e-7e89-4257-9e91-23151c17e5e7"
}
```

### Translate Text Check Job Status

`GET https://api.eu.apyhub.com/sharpapi/translate-text/job/status/:job_id` · 1 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `job_id` | path | string | yes | Example: `5de4887a-0dfd-49b6-8edb-9280e468c210`. |

#### Quickstart

Check the status of a translate-text job by its `job_id`.

```bash
curl -X GET "https://api.eu.apyhub.com/sharpapi/translate-text/job/status/:job_id" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` object. `data` contains `id` and `type` strings, plus an `attributes` object with `status` and `type`; when the job is complete, `attributes.result` includes the translated content and language pair.

```json
{
  "data": {
    "id": "5de4887a-0dfd-49b6-8edb-9280e468c210",
    "type": "api_job_result",
    "attributes": {
      "status": "success",
      "type": "content_translate",
      "result": {
        "content": "Translated text here",
        "to_language": "English",
        "from_language": "French"
      }
    }
  }
}
```

## About

## What it does
Text Translation lets you submit text for translation as an asynchronous job, then check the job status and retrieve the translated result when it is ready.

Send a `content` string, and optionally include `context`, `language`, and `voice_tone` to guide the translation. `context` helps disambiguate terms, `language` specifies the language of the source content, and `voice_tone` lets you steer style toward a tone such as funny, joyous, or a named authorial voice. The submit endpoint returns a `job_id` immediately so you can track the translation without blocking your workflow.

Use it when you need translated copy in a content pipeline, multilingual support workflow, or batch processing job. Poll `/job/status/:job_id` with the returned `job_id` to see whether the job is `queued`, `running`, `success`, or `failed`.

When a job completes successfully, the status response includes the translated `content` along with `from_language` and `to_language`, so you can store or route the result with its language metadata.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/sharpapi/service/translate-text
