> ## 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.2 Generación de imágenes

> - El modelo Midjourney V8.2 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 512 px en una sola ejecución
- Soporta generación texto-a-imagen e imagen-a-imagen (referenciando URLs de imágenes en el prompt)
- Las URLs de imágenes de entrada deben ser accesibles públicamente y descargables en unos 10 segundos; el proveedor descarga las imágenes de forma síncrona al crear la tarea y devuelve 400 si no puede. Los alojamientos de imágenes fuera de China continental (imgur, ibb, raw.githubusercontent, pinimg, picsum) fallan en la práctica. Aloje las imágenes en un CDN rápido o use la carga de archivos de la plataforma
- Aspectos destacados de V8.2: mejora estética y de calidad de imagen respecto a V8.1, nivel de detalle configurado con el parámetro nativo `--quality` / `--q` (1–4, 4 = modo de alta calidad) en el prompt sin costo adicional y salida 2K nativa (`quality=hd`). Turbo no está disponible en V8.2 (el proveedor documenta que V8 no admite turbo)
- Se admite la Referencia de estilo (`--sref`); `--oref` / `--cref` **no** se admiten en V8.2 y son rechazados por el proveedor, consulte la [guía de parámetros de prompt](/es/api-manual/image-series/midjourney/midjourney-v8-2-prompt-guide)
- Los parámetros de prompt que el proveedor no admite se transmiten tal cual: la tarea falla con un error de parámetro (`invalid_parameters`) y los créditos reservados se reembolsan (ya no se descartan silenciosamente)
- 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.2 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; el nivel de detalle se escribe en el prompt como `--quality` / `--q` (1–4) y se transmite sin cambios
- `mj-v8.2-edit` / `mj-v8.2-upload-paint` son ediciones de lienzo (img_pos + máscara). El endpoint de edición basada en instrucciones del proveedor (`--edit`, hasta 4 imágenes de referencia) todavía no está expuesto en esta ruta y su incorporación está programada

<Note>
  Midjourney cuenta con un sistema de moderación de contenido integrado. Cada imagen se modera por separado: las imágenes filtradas no aparecen en los resultados y el resto se entrega con normalidad, por lo que puedes recibir menos imágenes de lo habitual. Si al menos una imagen supera la revisión, la tarea queda en `completed` y se factura con normalidad; si se filtran todas las imágenes, la tarea termina en `failed` y los créditos reservados se reembolsan íntegramente. Asegúrate de que tus prompts e imágenes de referencia cumplan las directrices de contenido.
</Note>


## OpenAPI

````yaml es/api-manual/image-series/midjourney/mj-v8-2-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: Midjourney V8.2 Interfaz de generación de imágenes
  description: Crear tareas de generación de imágenes usando el modelo Midjourney V8.2
  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.2 Interfaz de generación de imágenes
      description: >-
        - El modelo Midjourney V8.2 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 512 px en una sola ejecución

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

        - Las URLs de imágenes de entrada deben ser accesibles públicamente y
        descargables en unos 10 segundos; el proveedor descarga las imágenes de
        forma síncrona al crear la tarea y devuelve 400 si no puede. Los
        alojamientos de imágenes fuera de China continental (imgur, ibb,
        raw.githubusercontent, pinimg, picsum) fallan en la práctica. Aloje las
        imágenes en un CDN rápido o use la carga de archivos de la plataforma

        - Aspectos destacados de V8.2: mejora estética y de calidad de imagen
        respecto a V8.1, nivel de detalle configurado con el parámetro nativo
        `--quality` / `--q` (1–4, 4 = modo de alta calidad) en el prompt sin
        costo adicional y salida 2K nativa (`quality=hd`). Turbo no está
        disponible en V8.2 (el proveedor documenta que V8 no admite turbo)

        - Se admite la Referencia de estilo (`--sref`); `--oref` / `--cref`
        **no** se admiten en V8.2 y son rechazados por el proveedor, consulte la
        [guía de parámetros de
        prompt](/es/api-manual/image-series/midjourney/midjourney-v8-2-prompt-guide)

        - Los parámetros de prompt que el proveedor no admite se transmiten tal
        cual: la tarea falla con un error de parámetro (`invalid_parameters`) y
        los créditos reservados se reembolsan (ya no se descartan
        silenciosamente)

        - 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.2 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; el
        nivel de detalle se escribe en el prompt como `--quality` / `--q` (1–4)
        y se transmite sin cambios

        - `mj-v8.2-edit` / `mj-v8.2-upload-paint` son ediciones de lienzo
        (img_pos + máscara). El endpoint de edición basada en instrucciones del
        proveedor (`--edit`, hasta 4 imágenes de referencia) todavía no está
        expuesto en esta ruta y su incorporación está programada
      operationId: createMjV82ImageGeneration
      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.2
                  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.2
                  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
              text_to_image_hd_quality:
                summary: Generación de imagen desde texto (HD + --q 3)
                value:
                  model: mj-v8.2
                  prompt: >-
                    A cinematic shot of a Maine Coon cat on a neon-lit balcony
                    --ar 16:9 --s 500 --q 3
                  quality: hd
                  model_params:
                    speed: fast
              image_to_image:
                summary: Imagen a imagen
                value:
                  model: mj-v8.2
                  prompt: >-
                    https://cdn.evolink.ai/model-cards/midjourney-v8-2/midjourney-v8-2-og-v1.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.2'
                  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.2
          default: mj-v8.2
          description: Nombre del modelo
        prompt:
          type: string
          description: >-
            Prompt, soporta toda la sintaxis nativa de parámetros de Midjourney
            V8.2 (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


            **Parámetros no admitidos:** los parámetros que el proveedor no
            admite (p. ej. `--oref`, `--cref`, `--stop`, `--bs`) se transmiten y
            el proveedor los rechaza explícitamente: la tarea falla con un error
            de parámetro (`invalid_parameters`) y los créditos reservados se
            reembolsan. `--v` / `--version` / `--niji` y los parámetros de
            velocidad / hd se eliminan y se controlan mediante parámetros de la
            API; `--quality` / `--q` (1–4) se transmite tal cual.
          maxLength: 2048
          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)
        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 o falla

            - 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-mjv82
        model:
          type: string
          description: Nombre del modelo utilizado
          example: mj-v8.2
        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:
        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

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.