> ## 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 Guía de parámetros de prompt
> Todos los parámetros disponibles en prompts del modelo Midjourney V8.2, incluyendo rangos de valores, valores predeterminados, dependencias, conflictos, reglas de imágenes de entrada, límites de longitud y el flujo de trabajo de tareas
## Resumen de parámetros
| Parámetro | Sintaxis | Tipo | Rango de valores | Valor predeterminado | Descripción |
| - | - | - | - | - | - |
| Relación de aspecto | `--ar W:H` | Ratio entero | Cualquier ratio de enteros positivos, sin decimales | 1:1 | Relación de aspecto de la imagen |
| Caos | `--c N` | int | 0 - 100 | 0 | Diversidad de los resultados generados |
| Semilla | `--seed N` | int | 0 - 4294967295 | Aleatorio | Fijar semilla para reproducir resultados |
| Estilización | `--s N` | int | 0 - 1000 | 100 | Intensidad del estilo artístico |
| Parámetro experimental | `--exp N` | int | 0 - 100 | 0 | Efecto estético, acumulable con la estilización |
| Calidad (nivel de detalle) | `--quality N` / `--q N` | int | 1 - 4 | 1 | Nivel de detalle de la imagen; 4 es el modo de alta calidad. Sin costo adicional. V8.1 solo acepta 1 / 4 |
| Modo raw | `--raw` | Interruptor | — | Desactivado | Desactivar embellecimiento predeterminado |
| Prompt negativo | `--no item1, item2` | Texto | — | — | Elementos que deben quedar fuera de la imagen |
| Peso de imagen | `--iw N` | float | 0 - 3 | 1 | Influencia del prompt de imagen |
| Referencia de estilo | `--sref [URL]` | URL | — | — | Coincidir con el estilo visual |
| Peso de estilo | `--sw N` | int | 0 - 1000 | 100 | Intensidad de la referencia de estilo |
| Personalización | `--p [code]` | Código | — | — | Id de moodboard creado por el canal del proveedor, transmitido tal cual |
| Mosaico | `--tile` | Interruptor | — | Desactivado | Generar patrones repetitivos sin costuras |
| Weird | `--weird N` / `--w N` | int | 0 - 3000 | 0 | Estética poco convencional y experimental |
Dos ajustes **no** se escriben en el prompt, sino que se controlan mediante la API (escribirlos en el prompt no tiene efecto, los parámetros se eliminan):
* **Velocidad** (`draft` / `fast`) → `model_params.speed`
* **Calidad de salida** (`standard` / `hd`) → parámetro `quality` de nivel superior
`--v` / `--version` está fijado en V8.2 y `--niji` no se admite. Consulte más abajo [Modos de velocidad](#modos-de-velocidad) y [Calidad de salida](#calidad-de-salida).
***
## Parámetros básicos
### Relación de aspecto `--ar`
Establece la relación de aspecto de la imagen. Solo admite ratios de enteros; los decimales se rechazan (escriba `139:100`, no `1.39:1`). Los ratios extremos son experimentales y pueden producir resultados impredecibles.
```
a cat --ar 16:9
```
Valores comunes: `1:1`, `4:3`, `3:2`, `16:9`, `9:16`, `2:3`. Consulte [Calidad de salida](#calidad-de-salida) para ver el tamaño en píxeles.
### Caos `--chaos` / `--c`
Controla la diversidad de los resultados generados. Cuanto mayor sea el valor, mayor será la diferencia entre las 4 imágenes.
```
a cat --c 50
```
| Rango | Efecto |
| - | - |
| 0 | Las 4 imágenes son muy consistentes (predeterminado) |
| 1-30 | Diferencias sutiles |
| 30-70 | Diversidad moderada |
| 70-100 | Diferencias notables, ideal para exploración creativa |
### Estilización `--stylize` / `--s`
Ajusta el equilibrio entre realismo y estilo artístico.
```
a cat --s 500
```
| Rango | Efecto |
| - | - |
| 0-250 | Estilo realista, fiel al prompt |
| 250-750 | Equilibrado |
| 750-1000 | Fuerte expresión artística, colores y composición audaces |
### Parámetro experimental `--exp`
Similar a `--stylize` pero acumulable, genera imágenes más detalladas, dinámicas y creativas.
```
a cat --exp 25
```
* Valores recomendados: 5, 10, 25, 50, 100
* De 5 a 50 el cambio de efecto es notable, de 50 a 100 los rendimientos son decrecientes
* Por encima de 25-50 puede anular el efecto de `--stylize` y `--p`; use valores más bajos al combinarlos
### Calidad `--quality` / `--q`
Establece el nivel de detalle de la imagen. Rango 1 - 4, predeterminado 1; `4` es el modo de alta calidad. El parámetro se transmite al proveedor tal cual y **no cambia el precio**.
```
a cat --q 3
```
* V8.2 acepta `1` / `2` / `3` / `4`; V8.1 solo acepta `1` / `4`. Los valores fuera de rango se rechazan: la tarea falla con un error de parámetro que indica `--quality` y sus valores permitidos, y los créditos reservados se reembolsan
* Los valores más altos tardan más en renderizarse
* Solo para la interfaz de generación de imágenes; las tareas derivadas (variación, remix, edición, etc.) heredan la imagen de origen
### Modo raw `--raw`
Desactiva el embellecimiento predeterminado y sigue más estrictamente los detalles del prompt. Adecuado para escenas que buscan realismo o control preciso.
```
product photo --raw
```
### Prompt negativo `--no`
Enumera los elementos que no deben aparecer en la imagen. Separe varios elementos con comas. Equivale a asignar a esos elementos un peso de -0.5. Escribir "no fruit" o "without fruit" en la descripción no funciona (Midjourney trata esas palabras como contenido), así que use el parámetro en su lugar.
```
still life gouache painting --no fruit, flowers
```
### Semilla `--seed`
Fija el estado aleatorio inicial, útil para pruebas comparativas.
```
a cat --seed 23453422
```
* Rango: 0 - 4294967295
* La semilla solo fija el estado inicial; no garantiza una salida idéntica, y cualquier cambio en el prompt, los parámetros o la versión del modelo cambia el resultado
* Use una semilla fija durante las pruebas y una semilla aleatoria en producción para obtener variedad
***
## Parámetros de referencia de imagen
### Prompt de imagen (imagen de referencia)
Coloque las URLs de imagen al **inicio** del prompt para influir en el contenido generado.
```
https://cdn.evolink.ai/model-cards/midjourney-v8-2/midjourney-v8-2-og-v1.jpg text description --iw 1.5
```
**Reglas de combinación válidas:**
| Combinación | ¿Es válida? |
| - | - |
| 1 imagen + sin texto | No válido (producirá 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 |
* Máximo 20 prompts de imagen
* Formatos admitidos: `.png`, `.gif`, `.webp`, `.jpg`, `.jpeg`; como máximo 20 MB por archivo y 16k píxeles por lado
* Los prompts solo de imagen (sin texto) son incompatibles con `--stylize` y `--weird`
* También funciona con la velocidad `draft` (verificado en esta plataforma); solo `--tile` no se puede combinar con `draft`
* Las URLs deben ser accesibles públicamente en unos pocos segundos, consulte [Requisitos de las imágenes de entrada](#requisitos-de-las-imágenes-de-entrada)
### Peso de imagen `--iw`
Controla la influencia de los prompts de imagen en el resultado. Rango 0 - 3, predeterminado 1. Cuanto mayor sea el valor, más se acerca a la imagen de referencia.
```
https://cdn.evolink.ai/model-cards/midjourney-v8-2/midjourney-v8-2-og-v1.jpg watercolor landscape --iw 2.0
```
### Referencia de estilo `--sref`
Coincide con el estilo visual de la imagen de referencia (colores, texturas, iluminación), sin copiar el contenido. **Debe usarse con un prompt de texto**.
```
a cat --sref https://cdn.evolink.ai/model-cards/midjourney-v8-2/midjourney-v8-2-og-v1.jpg
```
* Admite múltiples: `--sref URL1 URL2`; se pueden indicar pesos relativos con `--sref URL1::2 URL2::1` (documentado por el proveedor, aún no verificado en esta plataforma)
* Admite estilo aleatorio: `--sref random` (devuelve un código numérico después de la generación, reutilizable)
* Máximo 20 sref
* Mantenga el prompt de texto centrado en el contenido, no en instrucciones ("a cat", no "make this look like the reference")
### Peso de estilo `--sw`
Controla la influencia de la referencia de estilo. Rango 0 - 1000, predeterminado 100.
```
a cat --sref https://cdn.evolink.ai/model-cards/midjourney-v8-2/midjourney-v8-2-og-v1.jpg --sw 500
```
### Personalización `--p`
`--p` se transmite tal cual al proveedor. Acepta el id de un moodboard creado por el canal del proveedor bajo la cuenta de organización de esta plataforma; esta plataforma aún no expone endpoints para crear o listar moodboards, y los códigos de perfil personal de midjourney.com no son aplicables. Para un estilo coherente, use `--sref` / `--sw` junto con `--seed`. `--p` no se puede combinar con `--weird`.
```
a cat --p abc123
```
***
## Modos de velocidad
El modo de velocidad se controla mediante el campo `model_params.speed` de la API (no escriba `--draft` / `--fast` en el prompt).
Rutas que aceptan el campo: la generación de imágenes acepta `draft` / `fast`; remix, edición de lienzo, retexture y upload paint solo `fast`; variación y eliminación de fondo no tienen campo speed (variación acepta e ignora `speed: fast`; cualquier otro valor devuelve `400`).
| Modo | Descripción | Costo |
| - | - | - |
| `draft` | Devuelve 24 imágenes de boceto ligeras de 512 px en una sola ejecución. Solo para la interfaz de generación de imágenes. | Mismo multiplicador que fast |
| `fast` | Modo estándar (predeterminado), 4 imágenes por generación | Estándar |
A diferencia de V7, el modo `draft` de V8.2 **no** cuesta la mitad: usa el mismo multiplicador que `fast`. Draft devuelve 24 bocetos pequeños en una ejecución; elija los que le gusten y vuelva a ejecutarlos con calidad completa. Draft no se puede combinar con la calidad `hd` ni con `--tile` (`--oref` no es compatible con V8.2 en absoluto).
**Turbo no está disponible en V8.2.** El canal del proveedor documenta que V8 no admite el modo turbo, por lo que `speed: "turbo"` se rechaza con `400` en todos los endpoints de V8.2 (igual que en V8.1).
***
## Calidad de salida
La resolución de salida se controla mediante el parámetro `quality` de nivel superior, **no** mediante un parámetro en el prompt. No escriba `--hd` en el prompt.
| Valor | Resolución | Costo |
| - | - | - |
| `standard` | Resolución estándar, aproximadamente 1024 px en el lado largo para 1:1 (predeterminado) | 1x |
| `hd` | Salida 2K nativa, aproximadamente 2048 x 2048 para 1:1 | 1.5x |
* El multiplicador de calidad se **combina (multiplica)** con el multiplicador de velocidad
* `hd` es **incompatible** con la velocidad `draft`
* No existe un endpoint de upscale independiente en V8.2; el proveedor implementa el "upscale" de V8 como una nueva generación con `hd`, así que use `quality: "hd"` cuando necesite la salida 2K
***
## Límites de longitud del prompt
| Endpoint | Límite | Notas |
| - | - | - |
| `mj-v8.2` (generación de imágenes) | **1024 caracteres de descripción de texto** según lo impone el proveedor; la API acepta hasta 2048 caracteres en total | El proveedor cuenta solo la descripción, después de eliminar las URLs de imagen y los `--parámetros`. El margen adicional es para URLs y parámetros |
| `mj-v8.2-remix` / `-edit` / `-retexture` / `-upload-paint` | 8100 caracteres | El prompt se envía como instrucción de edición; la regla de 1024 no se aplica |
| `mj-v8.2-variation` / `-remove-bg` | — | `prompt` se ignora |
Una descripción demasiado larga se rechaza: la tarea falla con un error de parámetro (`invalid_parameters`) y los créditos reservados se reembolsan.
***
## Dependencias
Los siguientes parámetros requieren otros parámetros para funcionar:
| Parámetro | Dependencia previa |
| - | - |
| `--sw` | Requiere `--sref` |
| `--iw` | Requiere prompt de imagen |
| `--sref` | Requiere prompt de texto |
| Prompt de imagen único | Requiere prompt de texto |
***
## Conflictos
| Parámetro A | Parámetro B | Descripción |
| - | - | - |
| Velocidad `draft` | Calidad `hd` | El modo borrador no se puede combinar con HD |
| Velocidad `draft` | `--tile` | No se pueden combinar |
| `--weird` | `--p` | No se pueden combinar |
| Prompt solo de imagen | `--stylize` / `--weird` | Incompatible sin texto |
| `--exp` > 25 | `--stylize` / `--p` | Un `--exp` alto puede suprimirlos; reduzca `--exp` al combinarlos |
***
## Parámetros no admitidos en V8.2
V8.2 solo elimina los parámetros que romperían el bloqueo de versión o la facturación; **todos los demás parámetros se transmiten al proveedor tal cual**. Si el proveedor no admite un parámetro, la tarea falla con un error de parámetro (`invalid_parameters`) y los créditos reservados se reembolsan — nada se descarta silenciosamente.
| Parámetro | Tratamiento |
| - | - |
| `--v` / `--version` / `--niji` | Eliminado — la versión está fijada en V8.2 |
| `--fast` / `--turbo` / `--draft` / `--relax` | Eliminado — use `model_params.speed` (`draft` / `fast`; turbo no está disponible en V8.2) |
| `--hd` | Eliminado — use el parámetro `quality` de nivel superior |
| `--bs` / `--batchsize` | Eliminado — el tamaño de lote no es configurable |
| `--edit` | Reservado para el endpoint de edición por instrucciones del proveedor, que todavía no está expuesto en esta plataforma; rechazado por el proveedor en todos los endpoints actuales |
| `--oref` / `--ow` | Rechazado por el proveedor (no admitido en V8.2) |
| `--cref` / `--cw` | Rechazado por el proveedor (no admitido en V8.2) |
| `--stop` | Rechazado por el proveedor |
| Multi-prompt `::` | Rechazado por el proveedor |
| `--sv` | Solo se acepta `--sv 6`, y solo junto con `--sref` |
| `--repeat` / `--r`, permutaciones `{}`, `--stealth` / `--public` | No admitido a través de la API |
El canal del proveedor también ha abierto un endpoint de **edición basada en instrucciones** para V8.1 / V8.2 (el Edit Model de Midjourney: `--edit` con hasta 4 imágenes de referencia y repintado opcional con máscara transparente). Todavía no está expuesto en esta plataforma y su incorporación está programada. `mj-v8.2-edit` y `mj-v8.2-upload-paint` son ediciones de lienzo (`canvas` + `img_pos` + `mask` opcional), y `mj-v8.2-retexture` es la herramienta de retexturizado. Escribir `--edit` en un prompt en cualquiera de los endpoints actuales es rechazado por el proveedor.
***
## Requisitos de las imágenes de entrada
Estas reglas se aplican a los prompts de imagen, a las URLs de `--sref` y al campo `image_urls` de retexture / upload-paint / remove-bg.
* **Solo URLs HTTP(S) públicas.** No se aceptan Base64 ni data URLs para las imágenes de entrada. La propia URL debe tener como máximo 1024 caracteres.
* **El proveedor descarga la imagen de forma síncrona al crear la tarea y desiste tras unos 10 segundos** (medido en esta plataforma). Si no puede descargar el archivo a tiempo, la solicitud falla con `400` y no se crea ninguna tarea. En la práctica, los alojamientos de imágenes fuera de China continental (imgur, ibb, raw\.githubusercontent, pinimg, picsum y similares) fallan casi siempre. Aloje las imágenes en una CDN rápida o súbalas primero con la [API de carga de archivos](/docs/es/api-manual/file-series/upload-url) y use la URL devuelta.
* Formatos admitidos: `.png`, `.gif`, `.webp`, `.jpg`, `.jpeg` (`mj-v8.2-remove-bg` solo acepta `.png`, `.jpg`, `.jpeg`). Como máximo 20 MB por archivo y 16k píxeles por lado; los archivos muy grandes pueden agotar el tiempo de descarga incluso desde un host accesible.
* `mj-v8.2-remove-bg` no acepta los enlaces de resultado firmados que devuelven las tareas de Midjourney en esta plataforma (URLs que contienen `Expires` / `Signature`). Vuelva a alojar la imagen o use una URL sin firmar. Retexture y upload-paint sí aceptan esos enlaces.
* Los prompts de imagen y las URLs `--sref` también se aceptan con la velocidad `draft` (verificado en esta plataforma); solo `--tile` se rechaza junto con `draft`.
***
## Reglas de formato de prompt
### Estructura básica
```
[image URL] text description --param1 value1 --param2 value2
```
### Reglas de escritura
* Los parámetros van al **final** del prompt de texto
* Debe haber un **espacio** antes de `--`
* No usar signos de puntuación dentro de los parámetros
* No escribir texto después de los parámetros
* Para renderizar palabras dentro de la imagen, enciérrelas entre comillas dobles: `a neon sign that says "OPEN" --ar 3:2`
### Ejemplos
```text Correcto theme={null}
a yellow Persian cat --ar 1:2 --s 500
```
```text Incorrecto theme={null}
a yellow Persian cat--ar 2:3 ← missing space before --
a yellow Persian cat - - ar 2:3 ← space between --
a yellow Persian cat --ar 2:3, --s 50 ← punctuation in parameters
a yellow Persian cat --ar 2:3 more description ← text after parameters
```
***
## Flujo de trabajo de tareas
Los siete modelos V8.2 son asíncronos y se facturan por llamada.
1. **Enviar** — `POST /v1/images/generations` responde de inmediato con un `id` de tarea, `status: processing` y `usage.credits_reserved`. El trabajo en el proveedor se crea en segundo plano.
2. **Consultar** — `GET /v1/tasks/{task_id}` ([Consultar estado de la tarea](/docs/es/api-manual/task-management/get-task-detail)). El proveedor informa de un promedio de unos 40 segundos para generaciones y ediciones; consulte cada 3–5 segundos con un límite del lado del cliente de unos 20 minutos; no vuelva a enviar el mismo prompt mientras una tarea siga en `processing`. El proveedor limita la concurrencia por cuenta de organización; si se supera el límite, esta plataforma espera y reenvía automáticamente, de modo que, de su lado, la tarea solo tarda más en lugar de fallar.
3. **Leer el resultado** — cuando `status` es `completed`, `results` contiene las URLs de las imágenes: 4 para `fast`, 24 para `draft`. `usage.cost` muestra el cargo final.
4. **Guardar las imágenes** — los enlaces de resultado son URLs OSS firmadas válidas durante **30 días**; la firma solo cubre `GET`, por lo que una comprobación con `HEAD` devuelve `403`. Descargue o vuelva a alojar todo lo que necesite conservar.
5. **Callback opcional** — pase `callback_url` (HTTPS, host público) para recibir una notificación en `completed` / `failed`. Los callbacks se reintentan 3 veces con backoff; trátelos como una señal y confirme con la consulta de la tarea.
| Estado | Significado | ¿Final? |
| - | - | - |
| `pending` | Aceptada, esperando la cola del proveedor | No |
| `processing` | Renderizando | No |
| `completed` | Imágenes listas en `results` | Sí |
| `failed` | Error del proveedor, rechazo de parámetros, moderación o fallo de descarga; el mensaje está en `error` y los créditos reservados se reembolsan íntegramente | Sí |
Las tareas fallidas se reembolsan íntegramente, incluidas las solicitudes rechazadas en la creación, los rechazos de parámetros del proveedor (`--oref`, `--q` fuera de rango, descripción demasiado larga), los fallos de descarga de imágenes y las tareas en las que la moderación de contenido del proveedor bloquea **todas** las imágenes. Mientras al menos una imagen supere la moderación, la tarea queda en `completed` y se factura con normalidad. Los códigos de error y las pautas de reintento se encuentran en la página [Códigos de error](/docs/es/api-manual/task-management/error-codes).
### Tareas derivadas
Variation, remix y edición de lienzo toman como origen una tarea completada de la serie `mj-v8.2` de la misma cuenta (`task_id` + `image_number`). Reglas documentadas por el canal del proveedor y verificadas en esta plataforma:
* Para estas operaciones derivadas, las tareas de origen son renderizadas en el proveedor por el motor V7 de Midjourney, por lo que el resultado puede diferir ligeramente en estilo de la imagen de origen. El precio no cambia. No se aceptan orígenes V8.1.
* `image_number` selecciona la imagen de origen: `0`–`3` para una tarea de origen `fast`, `0`–`23` para una tarea de origen `draft` (los 24 bocetos pueden usarse como origen para variation, remix y edit).
* Los resultados de `mj-v8.2-upload-paint`, `mj-v8.2-retexture` y `mj-v8.2-remove-bg` **no** pueden usarse como origen para variation, remix o edit; el proveedor solo permite hacerles upscale, algo que esta ruta no expone. Use en su lugar una tarea de generación de imágenes, variation, remix o edit como origen.
***
## Preguntas frecuentes
**¿Necesito cambiar mis prompts al pasar de V8.1?**
No. Cambie el valor de `model`; los prompts, `model_params` y los precios no cambian. Solo `--oref` / `--ow` dejan de funcionar, y `--q` acepta `2` y `3` además de `1` y `4`.
**¿Por qué mi prompt de imagen falla con un 400 antes de que se cree cualquier tarea?**
El proveedor no pudo descargar la imagen dentro de su tiempo límite de descarga. Mueva el archivo a un host rápido y accesible públicamente o use la API de carga de archivos, y vuelva a intentarlo.
**¿Existe una velocidad turbo?**
No. El proveedor documenta que V8 no admite turbo, por lo que V8.2 solo ofrece `draft` y `fast`, igual que V8.1.
**¿`--q 4` es más lento o más caro?**
No se factura de forma diferente. El proveedor describe `4` como el modo de alta calidad, que tarda más en renderizarse.
**¿Puedo hacer upscale de una imagen V8.2?**
No existe un endpoint de upscale en V8.2. En su lugar, genere con `quality: "hd"` para obtener una salida 2K nativa.
***
## Aviso de moderación de contenido
Midjourney cuenta con un sistema de moderación de contenido integrado. Cada imagen se modera de forma individual: si algunas de las imágenes generadas son filtradas, la tarea sigue en `completed`, el resto de imágenes se entregan y la tarea 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úrese de que sus prompts cumplan con las directrices de contenido.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.