Introducción
Aporta la fuente en image_url y describe el cambio solicitado. Una máscara blanca sobre negro puede identificar la región de edición, las referencias pueden aportar estilo o contenido y la precisión high limita el alcance del cambio.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Empresa editora | Ideogram |
| Tareas admitidas | Generación de texto a imagen; edición de imagen a imagen |
| Capacidad de instrucción | Hasta 10.000 caracteres; letras deseadas entre comillas |
| Calidad al generar | low, medium (predeterminada), high |
| Calidad al editar |
|
| Resoluciones | 1k o 2k; el tamaño no altera tarifa de calidad |
| Relaciones de aspecto | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 |
| Guía de edición | Máscara opcional en blanco y negro; blanco señala qué cambiar |
| Referencias permitidas | Hasta cuatro imágenes de estilo o contenido; hasta tres con máscara |
| Precisión de cambio | regular o high; high restringe más los cambios |
| Cobro | Por imagen según calidad; tamaño, relación y referencias no cambian tarifa; los fallos no se cobran |
| Disponibilidad de resultados | Los archivos generados se eliminan después de 14 días |
Funciones y aspectos destacados
AFTER DARK con su línea de apoyo intacta
El cartel combina título rojo brillante con One night only debajo de una mujer con vestido de satén. Ambas cadenas se escribieron bien en medium, 1k y 2:3. Parte de esa jerarquía: asigna lugar a cada línea y describe figura, neón y textura impresa alrededor. Es una muestra medida de dos bloques proporcionados; comprueba las palabras en tu propio diseño.
Un destino sobre detalles de festival
LUMEN BAY combinó título grande con Summer Festival · July 12–14 más pequeño. Ambos quedaron claros en la escena costera de veleros y faro rayado. Da posiciones distintas al título y datos antes de describir la ilustración. La calidad selecciona nivel de cobro; 1k y 2k comparten esa tarifa.
Añade un lugar para el gato del invernadero
El banco de madera y gato naranja dormido aparecieron en el camino, sin cambiar plantas y luz circundantes. La solicitud nombra adiciones y conservación del resto. Para una región concreta, usa máscara con blanco en esa área. Referencias y high también tuvieron efecto, aunque cada salida requiere revisión visual.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Escribe la modificación solicitada en un máximo de 10.000 caracteres y pon entre comillas el texto que se deba añadir; estas instrucciones no modifican la tarifa basada en calidad. mínimo 1 caracteres · máximo 10000 caracteres |
image_url | Sí | Aporta en este campo la imagen que se modificará; la imagen de origen no añade un cargo aparte. mínimo 1 caracteres |
mask_url | No | Puedes aportar una máscara en blanco y negro en la que el blanco indique qué cambiar; usar una máscara no modifica el precio. mínimo 1 caracteres |
reference_image_urls | No | Adjunta hasta cuatro referencias de contenido o estilo, o hasta tres con una máscara, e identifícalas como Image 1 y números siguientes; la cantidad de referencias no afecta el… máximo 4 elementos |
aspect_ratio | No | Define el lienzo editado como 1:1, 4:3, 3:4, 3:2, 2:3, 16:9 o 9:16; las siete proporciones usan la tarifa de calidad elegida. |
quality | No | La edición acepta |
resolution | No | El resultado editado puede usar 1k o 2k sin un aumento de precio por tamaño. |
edit_precision | No | Selecciona regular o high; high mantiene la modificación más contenida. Esta elección no establece una tarifa adicional. |
Precios
Los cargos de edición dependen de la calidad e incluyen la opción very_low de menor precio; el tamaño, la proporción y la cantidad de referencias no añaden cargos, y las ediciones fallidas no se facturan.
| Especificación | Precio |
|---|---|
| $0.0096 / imagen |
| $0.036 / imagen |
| $0.072 / imagen |
| $0.264 / imagen |
Casos de uso
Carteles retro de cine y eventos nocturnos
Construye alrededor de un título entre comillas y una línea de evento separada. AFTER DARK escribió ambas líneas correctamente en medium, 1k y 2:3, con una figura de vestido de satén y tratamiento retro.
Ilustraciones de viajes y festivales
Coloca el destino sobre la escena ilustrada y detalles del evento abajo. LUMEN BAY mantuvo título grande y texto pequeño claros junto al paisaje costero.
Adiciones pequeñas en escenas existentes
Introduce un objeto concreto pidiendo conservar lugar y luz. El invernadero añadió banco de madera y gato naranja dormido, dejando igual el resto.
Revisiones guiadas por referencias
Aporta imágenes de paleta, material, estilo o contenido y explica sus papeles. Edición admite cuatro referencias, o tres al añadir máscara.
Regiones controladas de una composición
Marca el cambio en blanco sobre una máscara en blanco y negro y describe la región. high en precisión restringe más el cambio; las pruebas confirmaron efecto de máscaras y precisión.
Guía de prompts y consejos prácticos
Elige imagen nueva o edición
Empieza con texto a imagen para una composición escrita. Selecciona imagen a imagen si una fuente debe aportar la escena y envíala en
image_url.Separa texto y dirección artística
Pon entre comillas cada título y línea de apoyo e indica dónde va. Describe entorno, ropa, luz o textura gráfica alrededor de las letras.
Selecciona calidad y lienzo
Elige calidad para la tarifa por imagen y después 1k o 2k y una relación admitida. medium es la calidad predeterminada; edición también ofrece
very_low.Guía el cambio y revísalo
En edición, añade máscara opcional con regiones blancas y numera referencias según su papel. Revisa letras y detalles conservados y descarga la versión aceptada dentro de 14 días.
Revisa una imagen proporcionada
Ideogram 4.5 imagen a imagen toma image_url y aplica el cambio de prompt. Sirve para escenas existentes: añadir objetos, revisar detalles o incorporar guía visual. Nombra modificación y elementos por mantener para aclarar ambos.
El invernadero añadió banco de madera y gato naranja dormido al camino de piedra sin cambiar plantas y luz. Otras pruebas confirmaron máscaras, referencias y precisión high. Respaldan controles sin establecer preservación perfecta en toda solicitud.
Parámetros del editor
| Parámetro | Valores o capacidad | Función |
|---|---|---|
image_url | Imagen fuente | Identifica lo que se modifica. |
| prompt | Hasta 10.000 caracteres | Cambio, conservación y letras entre comillas. |
mask_url | Máscara opcional en blanco y negro | Blanco marca la región a cambiar. |
reference_image_urls | Cuatro referencias; tres con máscara | Estilo o contenido, como Image 1 y siguientes. |
edit_precision | regular o high | high restringe más la modificación. |
| quality | very_low, low, medium, high; medium predeterminado | Fija tarifa por imagen. |
| resolution | 1k o 2k | Tamaño de salida. |
aspect_ratio | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 | Forma del lienzo editado. |
Calidad y precisión resuelven preguntas distintas. Elige quality para facturación y edit_precision para limitar el cambio. Precisión high no equivale a calidad high.
Organiza la instrucción desde la fuente
Separa cambio y conservación
Empieza con acción directa: añadir banco, pintar etiqueta o cambiar un elemento. Sigue con plantas, mesa, luz o forma por conservar. No dejes que se infiera lo importante desde una solicitud general de mejora.
En invernadero, identifica lugar del banco y gato dormido y conserva entorno. Para letras, pon palabras exactas entre comillas y ubicación. Inspecciona tanto texto existente por conservar como el nuevo.
Usa máscara para la región
La máscara opcional es blanca y negra; blanco indica área de edición. Describe qué ocurrirá dentro y qué queda alrededor. Las pruebas confirmaron efecto de la máscara, sin implicar límites o alrededores idénticos en toda ejecución.
Recuenta referencias al añadir mask_url. Sin máscara caben cuatro, con máscara tres. La reducción afecta a referencias; image_url sigue identificando la fuente editable.
Distingue papeles de las referencias
La fuente define qué revisar; una referencia aporta estilo o contenido deseados. Identifica adjuntos Image 1, Image 2 y siguientes y describe sus aportaciones. Una paleta botánica puede orientar etiqueta sin reemplazar forma del producto.
Con varios adjuntos, resume funciones: uno guía material, otro colores. Termina con detalles retenidos de origen. Las pruebas confirman referencias funcionales sin demostrar transferencia de cada detalle.
Revisa antes de continuar
Contrasta con la fuente los puntos nombrados: objeto nuevo, escena conservada, letras y lienzo. El invernadero mantuvo plantas y luz alrededor del banco y gato. Es ejemplo individual, sin garantizar cadenas largas.
Para varias revisiones, guarda versión aceptada y concreta el siguiente paso. Comprueba cada salida antes de reutilizarla. Si hay personas, usa fotos autorizadas de adultos y no suplantes a nadie.
Qué determina la cuenta
Se cobra por imagen según calidad, con very_low como nivel de menor precio de edición. La calidad superior aumenta tarifa. Tamaño, relación y referencias no la cambian; precisión no añade una tarifa aparte. Una edición que falla queda sin facturar.
Consulta precios vigentes en la página de Ideogram 4.5. Elige 1k o 2k y forma por uso y calidad por presupuesto. Máscara y referencias orientan la tarea sin crear unidades nuevas de cobro.
Alcance y herramientas relacionadas
Ideogram aplica su filtro y rechaza sin cargo solicitudes marcadas. Guarda salidas aceptadas dentro de 14 días; después se eliminan.
Vuelve a texto a imagen para crear desde una escena escrita. Usa Ideogram Remove Background para recortar fotos o Ideogram Vector 1 para SVG. Elige por entrada y salida sin asumir que editar cambia el tipo de archivo.
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": "ideogram/4.5/edit",
"input": {
"edit_precision": "regular",
"image_url": "https://example.com/reference.png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"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.







