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:
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 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 apresentar o 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 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.