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 as poderosas funcionalidades 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, primeiro acesse o Painel de Controle da Ace Data Cloud para obter seu Token de API, que deve ser guardado para uso futuro.
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 a conclusão, você será redirecionado de volta para a página atual.
Um Token de API é suficiente para acessar todos os serviços da plataforma, não sendo necessário solicitar um para cada serviço individualmente. A primeira solicitação oferece um crédito gratuito, permitindo uma experiência sem custo; quando o crédito estiver baixo, você pode recarregar o saldo geral no painel de controle.
📘 Documentação Completa: API de Tradução de Localização →
Exemplo de Solicitação
Vamos usar um exemplo de entrada em inglês para demonstrar como usar essa 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 comoapplication/json.authorization: chave para chamar a API, que pode ser selecionada diretamente após a solicitação.
input: o texto que precisa ser traduzido.locale: idioma da tradução personalizada.extension: forma personalizada de apresentação do resultado da tradução.model: modelo de tradução utilizado, o padrão é gpt-3.5.
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:
CURL
Python
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, 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 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.