Saltar para o conteúdo principal
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 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 Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, 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:

​
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:

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

​
CURL

curl -X POST 'https://api.acedata.cloud/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

import requests

url = "https://api.acedata.cloud/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: 
{
  "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

{
  "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.