> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Midjourney V8.1 Generación de imágenes

> - El modelo Midjourney V8.1 admite la generación de imágenes de alta calidad mediante prompts en lenguaje natural. El modo Fast devuelve 4 imágenes por generación; el modo Draft devuelve 24 imágenes de boceto ligeras de 0.5K en una sola ejecución
- Soporta generación texto-a-imagen e imagen-a-imagen (referenciando URLs de imágenes en el prompt)
- Aspectos destacados de V8.1: salida HD nativa (`quality=hd`), generación aproximadamente 5x más rápida que la generación anterior, mejor renderizado de texto (el texto entre comillas se renderiza con mayor precisión) y mayor adherencia al prompt
- Compatible con los recursos de V7: se admiten Referencia de estilo (`--sref`) y Referencia Omni (`--oref`), consulte la [guía de parámetros de prompt](/es/api-manual/image-series/midjourney/midjourney-v8-1-prompt-guide)
- Modo de procesamiento asíncrono, use el ID de la tarea devuelto para [consultar el estado](/es/api-manual/task-management/get-task-detail)
- Los enlaces de imágenes generadas son válidos por 30 días, guárdelos lo antes posible
- Tiempo de espera: aproximadamente 20 minutos
- Notas de parámetros: esta ruta se ejecuta en V8.1 y no admite niji; configure el modo de velocidad mediante `model_params.speed` y la calidad de salida mediante el parámetro `quality` de nivel superior

<Note>
  Midjourney cuenta con un sistema de moderación de contenido integrado. Si algunas imágenes generadas son filtradas por la moderación, los créditos consumidos en esa solicitud no serán reembolsados. Asegúrese de que sus prompts cumplan con las directrices de contenido.
</Note>


## OpenAPI

````yaml es/api-manual/image-series/midjourney/mj-v8-1-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: Midjourney V8.1 Interfaz de generación de imágenes
  description: Crear tareas de generación de imágenes usando el modelo Midjourney V8.1
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Producción
security:
  - bearerAuth: []
paths:
  /v1/images/generations:
    post:
      tags:
        - Generación de imágenes
      summary: Midjourney V8.1 Interfaz de generación de imágenes
      description: >-
        - El modelo Midjourney V8.1 admite la generación de imágenes de alta
        calidad mediante prompts en lenguaje natural. El modo Fast devuelve 4
        imágenes por generación; el modo Draft devuelve 24 imágenes de boceto
        ligeras de 0.5K en una sola ejecución

        - Soporta generación texto-a-imagen e imagen-a-imagen (referenciando
        URLs de imágenes en el prompt)

        - Aspectos destacados de V8.1: salida HD nativa (`quality=hd`),
        generación aproximadamente 5x más rápida que la generación anterior,
        mejor renderizado de texto (el texto entre comillas se renderiza con
        mayor precisión) y mayor adherencia al prompt

        - Compatible con los recursos de V7: se admiten Referencia de estilo
        (`--sref`) y Referencia Omni (`--oref`), consulte la [guía de parámetros
        de
        prompt](/es/api-manual/image-series/midjourney/midjourney-v8-1-prompt-guide)

        - Modo de procesamiento asíncrono, use el ID de la tarea devuelto para
        [consultar el estado](/es/api-manual/task-management/get-task-detail)

        - Los enlaces de imágenes generadas son válidos por 30 días, guárdelos
        lo antes posible

        - Tiempo de espera: aproximadamente 20 minutos

        - Notas de parámetros: esta ruta se ejecuta en V8.1 y no admite niji;
        configure el modo de velocidad mediante `model_params.speed` y la
        calidad de salida mediante el parámetro `quality` de nivel superior
      operationId: createMjV81ImageGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageGenerationRequest'
            examples:
              text_to_image:
                summary: Generación de imagen desde texto
                value:
                  model: mj-v8.1
                  prompt: >-
                    A cinematic shot of a Maine Coon cat on a neon-lit balcony
                    --ar 16:9 --s 500
                  quality: standard
                  model_params:
                    speed: fast
              text_to_image_hd:
                summary: Generación de imagen desde texto (Fast + HD)
                value:
                  model: mj-v8.1
                  prompt: >-
                    A cinematic shot of a Maine Coon cat on a neon-lit balcony
                    --ar 16:9 --s 500
                  quality: hd
                  model_params:
                    speed: fast
              image_to_image:
                summary: Imagen a imagen
                value:
                  model: mj-v8.1
                  prompt: >-
                    https://example.com/ref.jpg A sunset landscape in watercolor
                    style --iw 1.5 --ar 16:9
                  quality: standard
                  model_params:
                    speed: fast
      responses:
        '200':
          description: Tarea creada exitosamente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageGenerationResponse'
        '400':
          description: Parámetros de solicitud inválidos
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: invalid_request
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: No autenticado, token inválido o expirado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Cuota insuficiente, recargue por favor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: insufficient_quota
                  message: Insufficient quota. Please top up your account.
                  type: insufficient_quota
        '403':
          description: Acceso denegado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: model_access_denied
                  message: 'Token does not have access to model: mj-v8.1'
                  type: invalid_request_error
        '429':
          description: Límite de velocidad excedido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: rate_limit_exceeded
                  message: Too many requests, please try again later
                  type: rate_limit_error
        '500':
          description: Error interno del servidor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: internal_error
                  message: Internal server error
                  type: api_error
components:
  schemas:
    ImageGenerationRequest:
      type: object
      required:
        - model
        - prompt
      properties:
        model:
          type: string
          enum:
            - mj-v8.1
          default: mj-v8.1
          description: Nombre del modelo
        prompt:
          type: string
          description: >-
            Prompt, soporta toda la sintaxis nativa de parámetros de Midjourney
            V8.1 (como --ar 16:9 --s 500).


            **Imagen a imagen:** Coloque las URLs de imagen al inicio del
            prompt. Formatos soportados: .png, .gif, .webp, .jpg, .jpeg


            **Reglas de imagen a imagen:**

            - 1 imagen + sin texto = **inválido** (devolverá error)

            - 1 imagen + descripción de texto = válido

            - 2+ imágenes + sin texto = válido

            - 2+ imágenes + descripción de texto = válido
          maxLength: 1024
          example: >-
            A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9
            --s 500
        quality:
          type: string
          enum:
            - standard
            - hd
          default: standard
          description: >-
            Calidad de salida


            - `standard`: Resolución estándar (predeterminado), multiplicador 1x

            - `hd`: Salida HD nativa, multiplicador 1.5x. Mutuamente excluyente
            con `speed: draft`


            **Información de costos:** el multiplicador de calidad se combina
            (multiplica) con el multiplicador de `speed`.
        model_params:
          type: object
          description: Parámetros del modelo
          properties:
            speed:
              type: string
              enum:
                - draft
                - fast
              default: fast
              description: >-
                Modo de velocidad


                - `draft`: Modo boceto. Devuelve 24 imágenes de boceto ligeras
                de 0.5K en una sola ejecución (en lugar de 4), ideal para
                explorar rápidamente ideas de composición. Mutuamente excluyente
                con `quality: hd`

                - `fast`: Modo estándar (predeterminado)


                **Información de costos:** `draft` y `fast` comparten el mismo
                multiplicador de velocidad (1x). Este multiplicador de velocidad
                luego se combina (multiplica) con el multiplicador de `quality`.
        callback_url:
          type: string
          description: >-
            Dirección de callback HTTPS después de completar la tarea


            **Momento del callback:**

            - Se activa cuando la tarea se completa, falla o se cancela

            - Se envía después de confirmar la facturación


            **Restricciones de seguridad:**

            - Solo se admite el protocolo HTTPS

            - Se prohíbe el callback a direcciones IP de red interna (127.0.0.1,
            10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)

            - La longitud de la URL no debe exceder `2048` caracteres


            **Mecanismo de callback:**

            - Tiempo de espera: `10` segundos

            - Máximo `3` reintentos después de fallar (a los `1`s/`2`s/`4`s
            respectivamente)

            - El formato de respuesta del callback es consistente con el de la
            interfaz de consulta de tareas

            - Si la dirección de callback devuelve un código 2xx se considera
            exitoso, otros códigos activan reintentos
          format: uri
          example: https://your-domain.com/webhooks/image-task-completed
    ImageGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Marca de tiempo de creación de la tarea
          example: 1757165031
        id:
          type: string
          description: ID de la tarea
          example: task-unified-1757165031-mjv81
        model:
          type: string
          description: Nombre del modelo utilizado
          example: mj-v8.1
        object:
          type: string
          enum:
            - image.generation.task
          description: Tipo de objeto de tarea
        progress:
          type: integer
          description: Porcentaje de progreso de la tarea (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: Estado de la tarea
          enum:
            - pending
            - processing
            - completed
            - failed
          example: pending
        task_info:
          $ref: '#/components/schemas/TaskInfo'
          description: Información de tarea asíncrona
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: Tipo de salida de la tarea
          example: image
        usage:
          $ref: '#/components/schemas/Usage'
          description: Información de uso y facturación
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Identificador de código de error
            message:
              type: string
              description: Mensaje de error
            type:
              type: string
              description: Tipo de error
    TaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: Si la tarea se puede cancelar
          example: true
        estimated_time:
          type: integer
          description: Tiempo estimado de finalización (segundos)
          minimum: 0
          example: 45
    Usage:
      type: object
      description: Información de uso y facturación
      properties:
        billing_rule:
          type: string
          description: Regla de facturación
          enum:
            - per_call
            - per_token
            - per_second
          example: per_call
        credits_reserved:
          type: number
          description: Créditos estimados consumidos
          minimum: 0
          example: 1.8
        user_group:
          type: string
          description: Grupo de usuario
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ## Todas las interfaces requieren autenticación con Bearer Token ##


        **Obtener API Key:**


        Visite la [página de gestión de API
        Key](https://evolink.ai/dashboard/keys) para obtener su API Key


        **Agregue lo siguiente al encabezado de la solicitud:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````