> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Integración y uso de la API de Traducción de Localización
> Localization translation 集成指南 - XHuoAPI
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](https://api.xhuoapi.ai/documents/6dcc60d0-a973-4ad2-92d8-11f4d3775532) para solicitar el servicio correspondiente. Una vez en la página, haga clic en el botón "Acquire", como se muestra en la imagen:
Si aún no ha iniciado sesión o registrado, será redirigido automáticamente a la [página de inicio de sesión](https://api.xhuoapi.ai) 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
```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/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
```python theme={null}
import requests
url = "https://api.xhuoapi.ai/v1/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:
```json theme={null}
{
"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
```json theme={null}
{
"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.