Skip to main content
La principal función de la API Midjourney Describe es obtener una descripción de una imagen a través de la carga de la misma. Para utilizar esta API, solo es necesario proporcionar la dirección del archivo de imagen, y la API devolverá una descripción detallada de la imagen. No se requieren configuraciones de parámetros complicadas para obtener descripciones de imágenes de alta calidad. Soporta múltiples formatos de imagen: ya sea JPEG, PNG o GIF, todos los formatos de imagen populares pueden ser fácilmente reconocidos y procesados. Este documento detallará las instrucciones de integración de la API Midjourney Describe, ayudándole a integrarla fácilmente y aprovechar al máximo las potentes funciones de esta API. A través de la API Midjourney Describe, puede automatizar la descripción de imágenes y mejorar la eficiencia de su negocio.

Proceso de solicitud

Para utilizar la API Midjourney Describe, primero debe ir a la página de solicitud Midjourney Describe API 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 Si aún no ha iniciado sesión o registrado, será redirigido automáticamente a la página de inicio de sesión que le invita 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 esta API sin costo.

Ejemplo de solicitud

Tomemos una imagen como ejemplo para demostrar cómo utilizar esta API. Supongamos que tenemos una imagen de paisaje, a continuación se muestra cómo cargar esa imagen y obtener una descripción.

Imagen de ejemplo de solicitud

Imagen de ejemplo

Configuración de encabezados de solicitud y cuerpo de solicitud

Request Headers incluye:
  • accept: especifica que se acepta una respuesta en formato JSON, aquí se debe escribir application/json.
  • authorization: la clave para llamar a la API, que puede seleccionarse directamente después de la solicitud.
Request Body incluye:
  • image_url: la dirección del archivo de imagen cargado.
Configurado 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 ya 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

Python

Ejemplo de respuesta

Después de una solicitud exitosa, la API devolverá 4 descripciones de la imagen. Por ejemplo:
Se puede ver que en el resultado hay un campo descriptions, que contiene cuatro resultados, cada uno de los cuales es una descripción candidata.

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

Conclusión

A través de este documento, ha aprendido cómo utilizar la API Midjourney Describe para la descripción de imágenes. 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.