Saltar al contenido principal
La función principal de la API de Traducción de Localización es obtener el texto traducido a partir de la entrada de texto que necesita ser traducido, y el idioma de la traducción se puede personalizar. Además, los resultados de la traducción se pueden presentar en dos formatos principales: json y markdown. Este documento detallará las instrucciones de integración de la API de Traducción, ayudándole a integrar y aprovechar al máximo las potentes funciones de esta API. A través de la API de Traducción, puede traducir fácilmente el texto ingresado a un idioma específico y admite formas específicas para presentar los resultados de la traducción.

​
Proceso de Solicitud

Para utilizar la API de Traducción de Localización, primero debe ir a la página de solicitud API de Traducción de Localización para solicitar el servicio correspondiente. Una vez en la página, haga clic en el botón “Acquire”, como se muestra en la imagen: Página de Solicitud Si aún no ha iniciado sesión o registrado, será redirigido automáticamente a la página de inicio de sesión para invitarlo a registrarse e iniciar sesión. Después de iniciar sesión o registrarse, será redirigido automáticamente a la página actual. En la primera solicitud, se le otorgará un crédito gratuito que le permitirá utilizar la API sin costo.

​
Ejemplo de Solicitud

Tomemos un ejemplo de entrada en inglés para demostrar cómo usar esta API. Supongamos que la descripción en inglés es: # Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph., a continuación, se mostrará cómo cargar la descripción en inglés y obtener el resultado de la traducción al chino, presentándolo en formato markdown.

​
Configuración de Encabezados y Cuerpo de Solicitud

Encabezados de Solicitud incluyen:
  • accept: especifica que se aceptan respuestas en formato JSON, aquí se debe escribir application/json.
  • authorization: la clave para llamar a la API, que se puede seleccionar directamente después de solicitarla.
Cuerpo de Solicitud incluye:
  • input: el texto que necesita ser traducido.
  • locale: el idioma de traducción personalizado.
  • extension: la forma de presentación del resultado de la traducción.
  • model: el modelo grande utilizado para la traducción, que por defecto es gpt-3.5.
Configuración como se muestra en la imagen a continuación:

​
Ejemplo de Código

Se puede observar que en el lado derecho de la página se han generado automáticamente códigos en varios lenguajes, como se muestra en la imagen:

Algunos ejemplos de código son los siguientes:

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

​
Ejemplo de Respuesta

Después de una solicitud exitosa, la API devolverá la información del resultado de esta tarea de traducción. Por ejemplo: 
{
  "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"
}
Se puede ver que en el resultado hay un campo data, que contiene la traducción al chino, y se devuelve en formato markdown. La otra información es la siguiente:
  • data, el resultado de esta tarea de traducción.
  • model, el modelo de lenguaje grande utilizado para esta tarea de traducción.
  • locale, el tipo de idioma de traducción de esta tarea.

​
Manejo de Errores

Al llamar a la API, si se encuentra con un error, la API devolverá el código de error y la información correspondiente. Por ejemplo:
  • 400 token_mismatched: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 400 api_not_implemented: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 401 invalid_token: No autorizado, token de autorización inválido o faltante.
  • 429 too_many_requests: Demasiadas solicitudes, ha superado el límite de tasa.
  • 500 api_error: Error interno del servidor, algo salió mal en el servidor.

​
Ejemplo de Respuesta de Error

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

​
Conclusión

A través de este documento, ha aprendido cómo utilizar la API de Traducción de Localización para traducir fácilmente el texto ingresado a un idioma específico y admite formas específicas para presentar los resultados de la traducción. Esperamos que este documento le ayude a integrar y utilizar mejor esta API. Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de soporte técnico.