> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Интеграция и использование Midjourney Translate API

> Midjourney generation 集成指南 - XHuoAPI

Основная функция Midjourney Translate API заключается в получении английского описания на основе введенного китайского описания content.

В этом документе подробно описывается интеграция Midjourney Translate API, чтобы помочь вам легко интегрировать и в полной мере использовать мощные возможности этого API. С помощью Midjourney Translate API вы можете легко преобразовать китайское описание content в английское описание content.

## Процесс подачи заявки

Чтобы использовать Midjourney Translate API, сначала необходимо перейти на страницу заявки [Midjourney Translate API](https://api.xhuoapi.ai/documents/e067d19b-7a66-4458-a45f-0fe88c1d5d34) и подать соответствующую заявку. После перехода на страницу нажмите кнопку «Acquire», как показано на изображении:

![Страница заявки](https://cdn.xhuoapi.ai/rci31i.png)

Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на [страницу входа](https://api.xhuoapi.ai), где вам предложат зарегистрироваться и войти в систему. После входа в систему вы будете автоматически возвращены на текущую страницу.

При первой подаче заявки предоставляется бесплатный лимит, который позволяет бесплатно использовать этот API.

## Пример запроса

Рассмотрим пример с китайским описанием, чтобы продемонстрировать, как использовать этот API. Предположим, что китайское описание: 精致，无暇，洁白的天使, далее мы покажем, как загрузить китайское описание и получить английское описание.

### Установка заголовков запроса и тела запроса

**Request Headers** включает:

* `accept`: указывает на прием ответа в формате JSON, здесь указывается `application/json`.
* `authorization`: ключ для вызова API, который можно выбрать из выпадающего списка после подачи заявки.

**Request Body** включает:

* `content`: загружаемое китайское описание.

> Только это одно поле достаточно для завершения перевода, убедитесь, что `content` использует китайское описание.

Настройте, как показано на изображении ниже:

![](https://cdn.xhuoapi.ai/db8lrn.png)

### Пример кода

Можно заметить, что на правой стороне страницы автоматически сгенерирован код на различных языках, как показано на изображении:

<p>
  <img src="https://cdn.xhuoapi.ai/oj1cck.png" width="500" className="m-auto" />
</p>

Некоторые примеры кода:

#### CURL

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/midjourney/translate' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "content": "精致，无暇，洁白的天使"
}'
```

#### Python

```python theme={null}
import requests

url = "https://api.xhuoapi.ai/v1/midjourney/translate"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "content": "精致，无暇，洁白的天使"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
```

### Пример ответа

После успешного запроса API вернет 1 описание переведенного китайского слова. Например:

```json theme={null}
{
  "content": "Exquisite, flawless, pure white angel"
}
```

Можно увидеть, что в результате есть поле `content`, содержащее переведенное английское описание, которое является переводом соответствующего китайского описания.

* `content`, генерирует соответствующее английское описание, которое можно использовать для описания задач по генерации изображений.

## Обработка ошибок

При вызове API, если возникнет ошибка, API вернет соответствующий код ошибки и информацию. Например:

* `400 token_mismatched`: Неверный запрос, возможно, из-за отсутствия или недействительных параметров.
* `400 api_not_implemented`: Неверный запрос, возможно, из-за отсутствия или недействительных параметров.
* `401 invalid_token`: Неавторизован, недействительный или отсутствующий токен авторизации.
* `429 too_many_requests`: Слишком много запросов, вы превысили лимит частоты.
* `500 api_error`: Внутренняя ошибка сервера, что-то пошло не так на сервере.

### Пример ответа об ошибке

```
{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
```

## Заключение

С помощью этого документа вы узнали, как использовать Midjourney Translate API для перевода загруженного китайского описания в английское описание. Надеемся, что этот документ поможет вам лучше интегрировать и использовать этот API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.