> ## 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 de Tradução de Localização

> Localization translation 集成指南 - XHuoAPI

A principal função da API de Tradução de Localização é obter o texto traduzido através da entrada de texto que precisa ser traduzido, enquanto o idioma da tradução pode ser personalizado, e os resultados da tradução podem ser apresentados em dois formatos principais: `json` e `markdown`.

Este documento irá detalhar as instruções de integração da API de Tradução, ajudando você a integrar facilmente e aproveitar ao máximo a poderosa funcionalidade dessa API. Com a API de Tradução, você pode facilmente traduzir o texto de entrada para um idioma específico e suportar formas específicas de apresentar os resultados da tradução.

## Processo de Solicitação

Para usar a API de Tradução de Localização, você precisa primeiro ir à página de solicitação [API de Tradução de Localização](https://api.xhuoapi.ai/documents/6dcc60d0-a973-4ad2-92d8-11f4d3775532) para solicitar o serviço correspondente. Após acessar a página, clique no botão "Adquirir", 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-o a se registrar e fazer login. Após o login ou registro, você será redirecionado automaticamente de volta para a página atual.

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

## Exemplo de Solicitação

Vamos usar uma entrada em inglês como exemplo para demonstrar como usar a API. Suponha que a descrição em inglês seja: `# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.`, a seguir, demonstraremos como enviar a descrição em inglês e obter o resultado da tradução em chinês, apresentando-o em formato markdown.

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

**Cabeçalhos da Solicitação** incluem:

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

**Corpo da Solicitação** inclui:

* `input`: o texto que precisa ser traduzido.
* `locale`: idioma da tradução personalizada.
* `extension`: forma personalizada de apresentar o resultado da tradução.
* `model`: modelo de tradução utilizado, o padrão é gpt-3.5.

Configuração conforme mostrado na imagem abaixo:

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

### 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/tn5nno.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/localization/translate' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
  "locale": "zh-CN",
  "extension": "md"
}'
```

#### Python

```python theme={null}
import requests

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

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

payload = {
    "input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
    "locale": "zh-CN",
    "extension": "md"
}

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

### Exemplo de Resposta

Após uma solicitação bem-sucedida, a API retornará as informações do resultado desta tarefa de tradução. Por exemplo:

```json theme={null}
{
  "data": "# 标题 1\n\n这是一个段落。\n\n## 标题 2\n\n这是另一个段落。",
  "usage": {
    "prompt_tokens": 172,
    "completion_tokens": 25
  },
  "model": "gpt-3.5-turbo-16k",
  "locale": "zh-CN"
}
```

Pode-se observar que o resultado contém um campo `data`, que inclui a tradução em chinês, retornando também em formato markdown, e outras informações são apresentadas da seguinte forma:

* `data`, resultado da tarefa de tradução.
* `model`, modelo de linguagem utilizado para a tarefa de tradução.
* `locale`, tipo de idioma da tradução da tarefa.

## Tratamento de Erros

Ao chamar a API, se ocorrer um erro, a API retornará o código de erro e as informações correspondentes. 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

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

## Conclusão

Através deste documento, você já entendeu como usar a API de Tradução de Localização para traduzir facilmente o texto de entrada para um idioma específico e suportar formas específicas de apresentar os resultados da tradução. 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.