Introducción
La primera URL aporta la imagen que se edita; las siguientes aportan material identificado como <Picture 2>, <Picture 3> y así sucesivamente en la instrucción.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Modelo y resultado | MiniMax H3-Image Open Weights; texto a imagen y edición; imágenes fijas |
| Límite del prompt | Obligatorio; hasta 5.000 caracteres en ambos endpoints |
| Niveles de resolución | 1k ~1 MP (predeterminado); 1.5k ~2,4 MP; 2k ~4 MP; 3k ~9,4 MP; 4k ~16,8 MP |
| Relaciones del lienzo | Quince opciones: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21 |
| Formas predeterminadas | Texto a imagen: 1:1; edición: sigue la fuente si omites |
| Entradas para editar | 1–9 imágenes; la fuente y hasta ocho referencias |
| Notación de imágenes | <Picture 1> identifica la fuente; <Picture 2> y siguientes, las referencias adicionales |
| seed | Opcional; permite comparar un cambio sin asegurar píxeles idénticos |
| Codificación | jpeg (predeterminada), png o webp; el formato no modifica el precio |
| Dimensiones medidas | 1k 3:4: 896 x 1184; 1.5k 9:16: 1152 x 2048; 2k 3:2: 2496 x 1664; 3k 1:1: 3072 x 3072; 4k 16:9: 5472 x 3072 |
| Tiempo del modelo observado | 11 de noviembre: 1k, 20–45 segundos por la mañana y 3–6 por la tarde; 4k, 36 segundos por la tarde; sin cola ni transferencia |
| Base de facturación | Por imagen completada según resolución; las ediciones suman un cargo por referencia posterior a la fuente; las solicitudes fallidas no se cobran |
Funciones y aspectos destacados
Luz azul de piscina frente a la ciudad
En 1.5k y 3:4 con seed 7, el ejemplo muestra a un hombre saliendo de una piscina de azotea por la noche, con luces urbanas y resplandor azul detrás. Aporta un retrato en el nivel intermedio junto a la escena cuadrada de desayuno de mayor tamaño.
Una mesa en el nivel medio grande
El desayuno devolvió una vista de 3072 x 3072 con pan, higos, miel y lino, usando seed 7.
Lleva a la ciclista a la escena costera
El montaje conservó la carretera y el cupé azul claro de <Picture 1> y colocó junto a ellos a la ciclista y la bicicleta de <Picture 2>.
Sustituye el cielo nublado por luz otoñal
Una imagen de origen se convirtió en un puente otoñal con hojas naranjas cayendo y niebla sobre el río.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Descripción obligatoria de la edición, de hasta 5.000 caracteres; identifica el origen con <Picture 1> y las referencias posteriores con . mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | Proporciona 1–9 URL en orden, con la imagen que se edita en primer lugar; no hay imagen de origen predeterminada. mínimo 1 elementos · máximo 9 elementos |
aspect_ratio | No | Formas admitidas: 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9. |
resolution | No | La salida editada usa 1k por defecto; también puedes elegir 1.5k, 2k, 3k o 4k, con mayor costo en cada nivel superior. |
output_format | No | Guarda la edición como jpeg (predeterminado), png o webp; los tres formatos comparten la tarifa del nivel seleccionado. |
seed | No | Fuente aleatoria opcional para comparar ediciones; omite el campo si no quieres fijarla. |
Precios
Cada edición completada se cobra a la tarifa del nivel elegido, con la primera entrada incluida; las posteriores suman pequeños cargos individuales. Los niveles más grandes cuestan más y las solicitudes fallidas no se cobran.
| Especificación | Precio |
|---|---|
| $0.024 / imagen |
| $0.042 / imagen |
| $0.06 / imagen |
| $0.132 / imagen |
| $0.204 / imagen |
Casos de uso
Retratos nocturnos con ambiente definido
Construye la escena editorial alrededor de una persona, una acción y una fuente de luz. El ejemplo de la piscina en la azotea devolvió a un hombre con luces urbanas y resplandor azul de la piscina en 1.5k, encuadre 3:4 y seed 7.
Composiciones de mesa en tamaños mayores
Describe los objetos y su disposición antes de elegir el nivel de salida. Nuestro desayuno cuadrado en 3k midió 3072 x 3072 y mostró pan, higos, miel y lino desde arriba.
Montajes con funciones de origen separadas
Asigna números distintos al entorno y al sujeto añadido. La edición costera conservó la carretera y el cupé azul claro e incorporó junto a ellos a la ciclista y su bicicleta desde otra referencia.
Cambios de estación con el sujeto conservado
Pide otra estación e iluminación y enumera los detalles que deben permanecer. La edición del puente conservó a la ciclista y la bicicleta, añadiendo hojas otoñales, luz dorada y niebla sobre el río.
Letreros con palabras breves proporcionadas
Pon entre comillas una etiqueta o letrero corto e indica dónde va. La comparación de prompts iguales reprodujo correctamente HOT SOUP 3 FRANCS en madera; los pasajes largos aún requieren revisión cuidadosa.
Guía de prompts y consejos prácticos
Parte de una escena o una fuente
Elige texto a imagen para un encargo escrito o edición para modificar una imagen existente. Al editar, utiliza fotos autorizadas de personas adultas y evita suplantaciones.
Describe el encuadre y la función de las referencias
Redacta en inglés frases conectadas sobre el entorno, el sujeto, la ropa, la luz y el punto de vista. En edición, llama <Picture 1> a la fuente y asigna un papel numerado a cada referencia posterior.
Ajusta forma, nivel y formato
Selecciona una resolución de 1k a 4k y una relación de aspecto para generar. La edición sigue la forma de origen si no indicas una relación; JPEG es el predeterminado y también están disponibles PNG y WebP.
Compara un cambio usando seed
Mantén seed y los demás ajustes mientras modificas una sola instrucción. Contrasta los detalles recibidos con el encargo: fijar seed ayuda a comparar sin prometer resultados idénticos.
Edita una fuente con referencias numeradas
El editor MiniMax H3-Image Open Weights parte de una imagen y sigue una solicitud escrita. Coloca la fuente al inicio de image_urls y añade referencias cuando otra imagen deba aportar un sujeto, objeto o detalle. Cada edición admite nueve imágenes: una fuente y hasta ocho referencias.
El montaje costero incorporó a una ciclista con bicicleta a una carretera con cupé azul claro. La edición otoñal cambió el entorno desde una sola fuente y conservó a la ciclista. Son encargos distintos con los mismos controles de fuente y referencias.
Parámetros para editar
| Parámetro | Significado en edición | Valor predeterminado o restricción |
|---|---|---|
image_urls | URLs ordenadas de fuente y referencias | Obligatorio; 1–9 imágenes en total |
prompt | Cambios, funciones de las fuentes y detalles por mantener | Obligatorio; hasta 5.000 caracteres |
aspect_ratio | Una forma de lienzo admitida | Sigue la fuente si se omite |
resolution | 1k, 1.5k, 2k, 3k o 4k | 1k; un nivel superior cuesta más |
output_format | jpeg, png o webp | jpeg; sin recargo por formato |
seed | Fuente aleatoria opcional para comparar de forma controlada | No asegura resultados idénticos |
Las relaciones son 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21 y 21:9. Omite aspect_ratio para que la forma original guíe la edición o configúralo si necesitas otro encuadre. Elige la resolución independientemente.
Asigna un trabajo a cada imagen
La fuente es <Picture 1> y la siguiente carga, <Picture 2>; continúa en orden. Utiliza esos tokens en el prompt y comprueba que coincidan con la lista de URLs. Hablar en general de "las referencias" deja ambiguas sus aportaciones.
Para un montaje, separa los papeles en prosa: "Conserva la carretera costera y el cupé de <Picture 1>. Añade a la mujer de unos treinta años y su bicicleta de <Picture 2> junto al auto estacionado. Iguala la luz de tarde y mantén su apariencia reconocible y chaqueta de mezclilla." Así, el entorno, el sujeto añadido y el objetivo de conservación tienen cláusulas propias.
Usa únicamente fotos que tengas derecho a utilizar. Las personas de entrada deben ser adultas; no suplantes a nadie. Los ejemplos describen personas de treinta años o más.
Explica qué cambia y qué permanece
Cuando cambies estación o entorno, indica qué conservar: persona, peinado, ropa o bicicleta. Describe después el reemplazo y su luz. Una instrucción concreta puede mantener a la ciclista en un puente de piedra y pedir hojas otoñales, luz dorada de mañana y niebla sobre el río. Al recibir la edición, revisa identidad y objetos importantes.
Si otra referencia aporta un objeto, nómbralo junto a su número e indica dónde ubicarlo. No necesitas llenar todos los espacios disponibles: incluye una imagen porque aporta algo que la instrucción puede identificar.
Usa seed para comparar un cambio
Mantén seed, orden de entradas, relación y nivel mientras modificas una sola cláusula, como estación o dirección de luz. Guarda la lista de entradas y el texto con la salida para identificar las diferencias entre solicitudes. seed conserva una fuente aleatoria para comparar, sin establecer píxeles idénticos ni preservación garantizada de todos los detalles.
Qué confirmaron las pruebas de edición
El montaje costero con dos referencias ubicó a la ciclista y la bicicleta junto al cupé azul claro, conservando la carretera original. En el ejemplo otoñal de una imagen, permanecieron la ciclista y la bicicleta mientras aparecían hojas naranjas, luz dorada y niebla de río. Las pruebas de ropa y entorno también conservaron una apariencia reconocible. Son observaciones individuales: compara cada nueva edición con sus propias fuentes.
Resultados NSFW registrados
Las revisiones de edición de la tarde del 11 de noviembre devolvieron una imagen por solicitud, sin rechazos, y cobraron esas entregas. Coincidieron con lo pedido Mild 3/3, Moderate 2/3, Strong 2/3, Very strong 0/3 y Maximum 6/6. Los demás resultados redujeron la intensidad. Recibir una imagen es distinto de que cumpla toda la solicitud; la muestra no predice cada edición futura.
Calcula el precio de una edición
El nivel de salida determina la tarifa por imagen e incluye la fuente. Cada imagen posterior añade un pequeño cargo. Los cinco niveles tienen tarifas distintas que aumentan con el tamaño; elegir JPEG, PNG o WebP no cambia la del nivel. No se cobran solicitudes fallidas. Consulta los precios vigentes del modelo y verifica la cantidad de entradas antes de enviar el montaje.
Restricciones y alternativas
Aquí no hay campos de prompt negativo, guía ni pasos de muestreo. El límite de entrada es nueve imágenes y la salida es fija, sin video ni audio. Una edición exitosa no garantiza que la identidad de origen, la forma de un objeto o las palabras pedidas coincidan perfectamente: examina los detalles del encargo.
Para generar desde prosa sin fuente, usa texto a imagen. La variante LoRA agrega hasta tres archivos de pesos de estilo. Si necesitas de diez a dieciséis entradas, considera MiniMax H3-Image, que usa image 1, image 2 y orden de carga en lugar de estos tokens. Esa versión no tiene seed y no se ha establecido equivalencia de salida. P-H3-Image es otro modelo; igualar prompt y seed no vuelve intercambiables sus resultados.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-image-open/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.

























