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

> Midjourney generation 集成指南 - XHuoAPI

La función principal de la API Midjourney Shorten es acceder al comando oficial `/shorten` (análisis de Prompt) de Midjourney, para analizar un Prompt, identificar las palabras clave con mayor peso y generar 5 Prompts candidatos más concisos. Esta interfaz es muy adecuada para:

* Reducir Prompts largos antes de llamar a `imagine`, mejorando la relevancia de la imagen generada;
* Entender inversamente el peso que Midjourney asigna a cada token a través de los Prompts candidatos, facilitando la ingeniería de Prompts;
* Integrarse en pipelines automatizados para agrupar y simplificar las palabras clave de los Prompts ingresados por los usuarios.

Este documento detalla las instrucciones para integrar la API Midjourney Shorten, ayudándole a integrar esta API fácilmente.

## Proceso de Solicitud

Para usar la API Midjourney Shorten, primero debe solicitar el servicio correspondiente en la página [Midjourney Shorten API](https://api.xhuoapi.ai/documents/f0c6be1d-c084-43ac-bde6-44ef9cf824a2). Al ingresar, haga clic en el botón «Acquire».

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 registrarse o iniciar sesión. Tras hacerlo, volverá automáticamente a esta página.

La primera solicitud incluye un crédito gratuito para usar la API sin costo.

## Ejemplo de Solicitud

Tomaremos un Prompt relativamente largo como ejemplo para demostrar cómo usar esta API para analizarlo y simplificarlo.

### Configuración de Headers y Cuerpo de la Solicitud

**Headers de la Solicitud** incluyen:

* `accept`: especifica que se recibe la respuesta en formato JSON, se debe poner `application/json`.
* `authorization`: la clave para llamar a la API, que puede seleccionarse directamente tras la solicitud.

**Cuerpo de la Solicitud** incluye:

* `prompt`: el texto del Prompt a analizar y simplificar, se recomienda ingresar en inglés.

### Ejemplo de Código

#### CURL

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/midjourney/shorten' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "prompt": "a serene mountain lake at sunrise, mist rising from the water, towering pine trees on the shore, golden hour lighting, ultra detailed, cinematic, 35mm film photography style, masterpiece --ar 16:9 --v 6"
}'
```

#### Python

```python theme={null}
import requests

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

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

payload = {
    "prompt": (
        "a serene mountain lake at sunrise, mist rising from the water, "
        "towering pine trees on the shore, golden hour lighting, ultra "
        "detailed, cinematic, 35mm film photography style, masterpiece "
        "--ar 16:9 --v 6"
    )
}

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

### Ejemplo de Respuesta

Tras una solicitud exitosa, la API devolverá hasta 5 Prompts candidatos simplificados. Por ejemplo:

```json theme={null}
{
  "prompts": [
    "a serene mountain lake at sunrise, mist rising from the water, golden hour lighting --ar 16:9",
    "mountain lake sunrise with mist, golden light --ar 16:9 --v 6",
    "tranquil alpine lake, dawn mist, warm golden tones, cinematic --ar 16:9",
    "sunrise over a misty mountain lake, rich golden hour photography --ar 16:9 --style raw",
    "misty lake at dawn, mountains in background, golden sunrise --ar 16:9"
  ]
}
```

Como se puede observar, el resultado contiene un campo `prompts` con varios Prompts candidatos simplificados, cada uno conserva las palabras clave con mayor peso interno de Midjourney y elimina descripciones repetidas o redundantes.

## Manejo de Errores

Al llamar a la API, si ocurre un error, esta devolverá un código y mensaje de error correspondiente. Por ejemplo:

* `400 token_mismatched`: Solicitud incorrecta, posiblemente por parámetros faltantes o inválidos.
* `400 api_not_implemented`: Solicitud incorrecta, posiblemente por parámetros faltantes o inválidos.
* `401 invalid_token`: No autorizado, token de autorización inválido o ausente.
* `429 too_many_requests`: Demasiadas solicitudes, se ha excedido el límite de tasa.
* `500 api_error`: Error interno del servidor, ocurrió un problema 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

Con este documento, ya sabe cómo usar la API Midjourney Shorten para analizar y simplificar Prompts. Se recomienda combinar esta API con la API Midjourney Imagine: primero obtener múltiples Prompts candidatos simplificados con Shorten API, luego seleccionar el más adecuado para pasarlo a Imagine API para generar imágenes. Si tiene alguna pregunta, no dude en contactar a nuestro equipo de soporte técnico.