> ## 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 Midjourney

> Midjourney generation 集成指南 - XHuoAPI

La principal función de la API de traducción de Midjourney es obtener descripciones en inglés a partir de descripciones en chino ingresadas como contenido.

Este documento detallará las instrucciones de integración de la API de traducción de Midjourney, ayudándole a integrar y aprovechar al máximo las potentes funciones de esta API. A través de la API de traducción de Midjourney, puede convertir fácilmente descripciones en chino en descripciones en inglés.

## Proceso de solicitud

Para utilizar la API de traducción de Midjourney, primero debe ir a la página de solicitud [API de traducción de Midjourney](https://api.xhuoapi.ai/documents/e067d19b-7a66-4458-a45f-0fe88c1d5d34) 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](https://cdn.xhuoapi.ai/rci31i.png)

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, lo que le permitirá utilizar la API de forma gratuita.

## Ejemplo de solicitud

Tomemos un ejemplo de una descripción en chino para demostrar cómo usar la API. Supongamos que la descripción en chino es: "精致，无暇，洁白的天使", a continuación, se demostrará cómo cargar la descripción en chino y obtener la descripción en inglés.

### Configuración de los encabezados de solicitud y el cuerpo de la solicitud

**Encabezados de solicitud** incluyen:

* `accept`: especifica que se aceptan respuestas en formato JSON, aquí se debe ingresar `application/json`.
* `authorization`: la clave para llamar a la API, que se puede seleccionar directamente después de la solicitud.

**Cuerpo de la solicitud** incluye:

* `content`: la descripción en chino que se va a cargar.

> Solo este campo es necesario para completar la traducción, asegúrese de que `content` use la descripción en chino.

La configuración es como se muestra en la siguiente imagen:

![](https://cdn.xhuoapi.ai/db8lrn.png)

### 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:

<p>
  <img src="https://cdn.xhuoapi.ai/oj1cck.png" width="500" className="m-auto" />
</p>

Algunos ejemplos de código son los siguientes:

#### CURL

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/midjourney/translate' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "content": "精致，无暇，洁白的天使"
}'
```

#### Python

```python theme={null}
import requests

url = "https://api.xhuoapi.ai/v1/midjourney/translate"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "content": "精致，无暇，洁白的天使"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
```

### Ejemplo de respuesta

Después de una solicitud exitosa, la API devolverá una descripción traducida de la descripción en chino. Por ejemplo:

```json theme={null}
{
  "content": "Exquisite, flawless, pure white angel"
}
```

Se puede ver que en el resultado hay un campo `content`, que contiene la descripción en inglés traducida, que es el resultado de la traducción de la descripción en chino correspondiente.

* `content`, genera la descripción en inglés correspondiente, que se puede utilizar para tareas de generación de imágenes.

## 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 Midjourney para traducir descripciones en chino cargadas a descripciones en inglés. 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.
