Integración y uso de la API de Traducción de Localización

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 usar la API de Traducción de Localización, primero dirígete a la consola de Ace Data Cloud para obtener tu token de API, que debes guardar para uso futuro.

Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invitará a registrarte e iniciar sesión. Una vez completado, serás devuelto automáticamente a la página actual. Un token de API es suficiente para acceder a todos los servicios de la plataforma, no es necesario solicitar uno por cada servicio. La primera solicitud incluirá un crédito gratuito para que puedas probarlo; si el crédito es insuficiente, puedes recargar el saldo general en la consola.

📘 Documentación completa: API de Traducción de Localización →

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 subir 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

Request Headers incluye:

accept: especifica que se acepta una respuesta 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.

Request Body incluye:

input: el contenido que necesita ser traducido. Se debe pasar como cadena cuando extension=md, y como objeto JSON cuando extension=json.
locale: el idioma de traducción personalizado.
extension: el formato del contenido de entrada, puede ser md o json.
model: el modelo grande utilizado para la traducción, por defecto es gpt-3.5.

`extension`	Tipo de `input`	Ejemplo
`md`	string	`"# Title\n\nParagraph"`
`json`	object	`{"title": "Hello", "button": "Submit"}`

extension debe coincidir con el tipo de input; las cadenas no pueden usar json, y los objetos JSON no pueden usar md. Configúralo 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, has 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 usar 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.

Primeros pasos

Chat de IA

Imagen de IA

Video de IA

Audio de IA

Web y datos

CAPTCHA

Identidad

Proxy

Avanzado

Coding

Integración y uso de la API de Traducción de Localización

Proceso de Solicitud

Ejemplo de Solicitud

Configuración de Encabezados y Cuerpo de Solicitud

Ejemplo de Código

CURL

Python

Ejemplo de Respuesta

Manejo de Errores

Ejemplo de Respuesta de Error

Conclusión

​Proceso de Solicitud

​Ejemplo de Solicitud

​Configuración de Encabezados y Cuerpo de Solicitud

​Ejemplo de Código

​CURL

​Python

​Ejemplo de Respuesta

​Manejo de Errores

​Ejemplo de Respuesta de Error

​Conclusión

Proceso de Solicitud

Ejemplo de Solicitud

Configuración de Encabezados y Cuerpo de Solicitud

Ejemplo de Código

CURL

Python

Ejemplo de Respuesta

Manejo de Errores

Ejemplo de Respuesta de Error

Conclusión