Saltar al contenido principal

​
Introducción

Localization es un servicio de herramientas proporcionado por Ace Data Cloud para traducción y localización mediante IA. A través de la API unificada de Ace Data Cloud, puedes integrar rápidamente Localization con Python para realizar traducción de Markdown, traducción de JSON, soporte para 18 idiomas, mantener el formato, entre otras funciones.

​
Requisitos previos

  • Tener una cuenta en Ace Data Cloud y obtener un API Token
  • Entorno Python 3.7 o superior
  • Instalar la librería requests: pip install requests

​
Uso básico

El endpoint principal para llamar a la API de Localization es: 
POST https://api.acedata.cloud/localization/translate
Este ejemplo utiliza el modelo gpt-4.
Modelos disponibles: gpt-3.5, gpt-4. Ejemplo completo de código Python: 
import requests

url = "https://api.acedata.cloud/localization/translate"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "input": "# 欢迎使用\n\n这是一段示例文本。",
    "locale": "en",
    "extension": "md",
    "model": "gpt-4"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Por favor, reemplaza YOUR_API_TOKEN con el Token real que obtuviste en la plataforma Ace Data Cloud.

​
Manejo de la respuesta

Tras una llamada exitosa, la API devuelve datos en formato JSON. Se recomienda verificar el código de estado HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Llamada exitosa:", result)
else:
    print(f"Llamada fallida, código de estado: {response.status_code}")
    print(response.text)

​
Uso avanzado

Para APIs que soportan tareas asíncronas, puedes obtener resultados mediante una URL de callback: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Los resultados serán enviados a tu servidor vía la URL de callback

​
Manejo de errores

Códigos de error comunes:
CódigoDescripción
401Autenticación fallida, verifica el API Token
403Saldo insuficiente o acceso denegado
429Límite de frecuencia de solicitudes excedido
500Error interno del servidor

​
Próximos pasos