Skip to main content

​
Resumen de parámetros

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 y 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.
Valores comunes: 1:1, 4:3, 3:2, 16:9, 9:16, 2:3. Consulte 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.

​
Estilización --stylize / --s

Ajusta el equilibrio entre realismo y estilo artístico.

​
Parámetro experimental --exp

Similar a --stylize pero acumulable, genera imágenes más detalladas, dinámicas y creativas.
  • 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.
  • 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.

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

​
Semilla --seed

Fija el estado aleatorio inicial, útil para pruebas comparativas.
  • 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.
Reglas de combinación válidas:
  • 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

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

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

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

​
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).
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.
  • 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

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:

​
Conflictos

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

​
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

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

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