> ## 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.

# Integração e Uso da API Midjourney Translate

> Midjourney generation 集成指南 - XHuoAPI

A principal função da API Midjourney Translate é obter descrições em inglês a partir de descrições em chinês inseridas como conteúdo.

Este documento irá detalhar as instruções de integração da API Midjourney Translate, ajudando você a integrar facilmente e aproveitar ao máximo as poderosas funcionalidades dessa API. Com a API Midjourney Translate, você pode facilmente converter descrições em chinês em descrições em inglês.

## Processo de Solicitação

Para usar a API Midjourney Translate, você precisa primeiro acessar a página de solicitação [Midjourney Translate API](https://api.xhuoapi.ai/documents/e067d19b-7a66-4458-a45f-0fe88c1d5d34) para solicitar o serviço correspondente. Após acessar a página, clique no botão "Acquire", conforme mostrado na imagem:

![Página de Solicitação](https://cdn.xhuoapi.ai/rci31i.png)

Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a [página de login](https://api.xhuoapi.ai), convidando você a se registrar e fazer login. Após o registro e login, você será redirecionado de volta para a página atual.

Na primeira solicitação, haverá um crédito gratuito disponível, permitindo que você use a API sem custo.

## Exemplo de Solicitação

Vamos usar uma descrição em chinês como exemplo para demonstrar como usar a API. Suponha que a descrição em chinês seja: "精致，无暇，洁白的天使", a seguir, demonstraremos como enviar a descrição em chinês e obter a descrição em inglês.

### Configurando o Cabeçalho e o Corpo da Solicitação

**Request Headers** incluem:

* `accept`: especifica que a resposta deve ser no formato JSON, preenchido como `application/json`.
* `authorization`: a chave para chamar a API, que pode ser selecionada diretamente após a solicitação.

**Request Body** inclui:

* `content`: a descrição em chinês a ser enviada.

> Apenas este campo é necessário para completar a tradução, certifique-se de que `content` use a descrição em chinês.

Configuração conforme mostrado na imagem abaixo:

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

### Exemplo de Código

Pode-se notar que, no lado direito da página, já foram gerados automaticamente códigos em várias linguagens, conforme mostrado na imagem:

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

Alguns exemplos de código são os seguintes:

#### 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)
```

### Exemplo de Resposta

Após uma solicitação bem-sucedida, a API retornará uma descrição traduzida da descrição em chinês. Por exemplo:

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

Pode-se observar que o resultado contém um campo `content`, que inclui a descrição em inglês traduzida, correspondente à descrição em chinês.

* `content`, gera a descrição em inglês correspondente, que pode ser usada para tarefas de geração de imagens.

## Tratamento de Erros

Ao chamar a API, se ocorrer um erro, a API retornará o código de erro e a mensagem correspondente. Por exemplo:

* `400 token_mismatched`: Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
* `400 api_not_implemented`: Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
* `401 invalid_token`: Não autorizado, token de autorização inválido ou ausente.
* `429 too_many_requests`: Muitas solicitações, você excedeu o limite de taxa.
* `500 api_error`: Erro interno do servidor, algo deu errado no servidor.

### Exemplo de Resposta de Erro

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

## Conclusão

Com este documento, você já entende como usar a API Midjourney Translate para traduzir descrições em chinês enviadas para descrições em inglês. Esperamos que este documento ajude você a integrar e usar melhor essa API. Se tiver alguma dúvida, entre em contato com nossa equipe de suporte técnico.