Introducción
Envía la composición en prompt e incluye las palabras del diseño entre comillas. Elige el nivel de calidad por separado del tamaño y la proporción; la ampliación del prompt puede desarrollar una descripción breve.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| 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í | Describe la imagen en hasta 10.000 caracteres y pon entre comillas el texto que quieras incluir; la extensión del prompt no determina el precio. mínimo 1 caracteres · máximo 10000 caracteres |
aspect_ratio | No | Elige 1:1, 4:3, 3:4, 3:2, 2:3, 16:9 o 9:16 para definir la composición; la proporción no añade cargos. |
quality | No | Elige low, medium (predeterminado) o high para generar; los niveles de calidad superiores cuestan más por imagen. |
resolution | No | Selecciona 1k o 2k para el tamaño de imagen sin cambiar el cargo del nivel de calidad. |
enable_prompt_expansion | No | Activa esta opción para permitir que el modelo amplíe una instrucción breve antes de generar; el cobro sigue vinculado a la calidad. Valor predeterminado: |
Precios
Cada imagen generada se cobra según el nivel de calidad seleccionado; la resolución y la proporción no cambian esa tarifa, y las solicitudes sin resultado no generan cargos.
| Especificación | Precio |
|---|---|
| $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.
Crea una composición con palabras
Ideogram 4.5 texto a imagen parte de una escena y coloca letras proporcionadas dentro. Sirve para carteles nuevos, portadas ilustradas o gráficos de evento desde un encargo escrito. El texto entre comillas define palabras; la dirección artística describe su entorno.
Dos carteles medidos respaldan el endpoint. LUMEN BAY combinó destino claro con festival pequeño. AFTER DARK integró título rojo brillante y One night only en una composición retro con vestido de satén. Muestran diseños concretos sin prometer toda frase o disposición.
Parámetros y papeles
| Parámetro | Opciones o capacidad | Uso |
|---|---|---|
| prompt | Hasta 10.000 caracteres | Composición y letras necesarias entre comillas. |
| quality | low, medium, high; medium por defecto | Nivel de facturación por imagen. |
| resolution | 1k o 2k | Tamaño sin modificar tarifa del nivel. |
aspect_ratio | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 | Forma según destino. |
enable_prompt_expansion | Expansión opcional | Elabora instrucciones cortas antes de generar. |
Generación no incluye very_low de edición. Si necesitas fuente, usa imagen a imagen, que también aporta máscaras, referencias y precisión.
Precio por calidad
Cada imagen entregada se cobra según calidad. Pasar de low a medium o high aumenta tarifa; cambiar 1k por 2k no. Las siete relaciones comparten la tarifa elegida. La longitud del prompt es capacidad del encargo y no unidad de cobro.
Consulta precios vigentes en la página de Ideogram 4.5 antes de elegir nivel. Las solicitudes sin éxito no tienen cargo. Decide por separado calidad y lienzo: una fija tarifa y los otros tamaño y forma.
Integra las letras al diseño
Da trabajo a cada bloque
Decide palabras antes de adornos. Un orden útil: título, apoyo, posiciones y escena. Para AFTER DARK coloca título entre comillas sobre figura y línea breve de evento en margen inferior.
Incluye toda la cadena entre comillas, con puntuación importante. Di cuál domina y cuál es pequeña. Así hay jerarquía en lugar de palabras de igual peso. Contrasta título y apoyo con el original antes de usar.
Dirige con detalles concretos
Si aparecen personas, describe sujeto, ropa, lugar, ambiente y luz. Una adulta de casi cuarenta con vestido de noche de satén fuera de un cine con neón define más que un retrato inespecífico. Un hombre de unos cuarenta con camisa de cuello abierto en un andén da otra dirección. Usa treinta años o más en las escenas sugeridas.
Escoge tratamiento que sirva al encargo, como serigrafía y paleta limitada para retro. Configura relación además de describir ubicación de letras. Un cartel alto puede usar 2:3 y uno ancho las relaciones horizontales admitidas.
Amplía un punto de partida corto
enable_prompt_expansion permite ampliar una instrucción antes de generar. Las pruebas confirmaron efecto del control. Escribe tú título y evento exactos incluso con expansión: las palabras son decisiones de diseño que puedes aportar directamente.
Qué mostraron las pruebas
- LUMEN BAY representó claramente título y Summer Festival · July 12–14.
- En medium, 1k y 2:3, AFTER DARK escribió título y One night only correctamente y mostró la figura con vestido de satén mirando atrás.
- La expansión tuvo efecto; no establece mejora para todos los prompts.
Revisa texto pequeño tan cuidadosamente como título. Los ejemplos respaldan esas disposiciones sin tasa medida de éxito para diseños ajenos o textos largos.
Límites y siguiente flujo
Ideogram revisa solicitudes y rechaza sin cargo lo bloqueado. Los archivos se eliminan tras 14 días: descarga la elegida con prompt y ajustes.
Selecciona imagen a imagen en esta página para que una fuente defina la escena por cambiar. Para SVG sigue a Ideogram Vector 1. Para eliminar fondo de foto, abre Ideogram Remove Background. Sus entradas y salidas difieren de un cartel nuevo.
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"resolution": "1k",
"aspect_ratio": "1:1"
}
}'
# 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.






