Saltar al contenido principal

​
Introducción

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

​
Requisitos previos

  • Tener una cuenta en Ace Data Cloud y obtener un API Token
  • Node.js 18+ o un entorno de navegador moderno

​
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 incluyen: gpt-3.5, gpt-4. Ejemplo completo de código JavaScript: 
const response = await fetch("https://api.acedata.cloud/localization/translate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "input": "# 欢迎使用\n\n这是一段示例文本。",
  "locale": "en",
  "extension": "md",
  "model": "gpt-4"
}),
});

const result = await response.json();
console.log(result);
Por favor, reemplaza YOUR_API_TOKEN con el Token real que obtuviste en la plataforma Ace Data Cloud.

​
Manejo de la respuesta

Se recomienda verificar el código de estado de la respuesta y manejar errores: 
if (response.ok) {
  const result = await response.json();
  console.log("Llamada exitosa:", result);
} else {
  console.error(`Llamada fallida, código de estado: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Encapsulación en Node.js

Se recomienda encapsular en una función reutilizable: 
async function callLocalization(data) {
  const response = await fetch("https://api.acedata.cloud/localization/translate", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`Error en API: ${response.status}`);
  return response.json();
}

​
Manejo de errores

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

​
Próximos pasos