Saltar al contenido principal

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.

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. 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 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

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

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: 
{
  "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.