Introducción
Ampliar con creatividad
Bloom incorpora contenido nuevo durante la ampliación. Si no indicas preset, utiliza bloom_2.
Solicitud Bloom
Selecciona 2k, 4k u 8k, con 4k por defecto. La creatividad empieza en 3 y el prompt es opcional.
Límites creativos
Revisa los rostros y las superficies en el JPEG o PNG descargado. Realism rechaza valores de creatividad superiores a 4.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Modelo inicial |
|
| Alternativas |
|
| Nivel por defecto | 4K |
| Guía opcional |
|
| Archivo final | JPEG o PNG |
Funciones y aspectos destacados
Bloom 2 aporta más textura al rostro
Sin prompt y con creatividad 3, Bloom 2 reconstruyó ojos, barba y textura de piel. La imagen derecha interpreta la cara; no demuestra qué detalle había capturado la cámara.
Compara los acabados sobre el mismo retrato
De izquierda a derecha: Bloom 2, Bloom Realism y Bloom. Bloom 2 presenta más textura; Realism define la cara con cambios leves de parecido; Bloom queda más suave en esta prueba. Tardaron unos 86, 134 y 273 segundos.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La imagen existente cuya composición Bloom ampliará e interpretará. mínimo 1 caracteres |
preset | No |
|
resolution | No | Nivel Bloom |
prompt | No | Descripción opcional de la escena o el acabado para orientar los detalles añadidos. máximo 2000 caracteres |
creativity | No | Entero de 1–9, con 3 por defecto: 1 conserva más la fuente y 9 añade más detalles. |
output_format | No | Elige |
Precios
En Bloom, únicamente resolution cambia el cargo por imagen. El preset, el prompt, la creatividad y elegir JPEG o PNG no alteran ese costo.
| Especificación | Precio |
|---|---|
| $0.36 / imagen |
| $1.08 / imagen |
| $4.08 / imagen |
Casos de uso
Desarrollar una ilustración
Amplía tu obra y permite nuevos detalles de superficie; describe el acabado deseado en prompt.
Buscar un acabado fotográfico
Elige bloom_realism con creativity entre 1 y 4 para una interpretación de aspecto natural.
Guía de prompts y consejos prácticos
Parte de una imagen
Indica en
image_urlla obra que Bloom debe ampliar.Orienta la creación
Selecciona preset y creatividad; si lo deseas, añade una descripción del resultado buscado.
Evalúa la nueva versión
Elige el nivel de salida y comprueba si los rostros y detalles añadidos encajan en tu obra.
Ampliar con creatividad
Amplía una imagen existente con Bloom y orienta los detalles nuevos mediante el preset, un prompt opcional y el control de creatividad.
Solicitud Bloom
{
"image_url": "https://example.com/blurred-portrait.jpg",
"preset": "bloom_2",
"resolution": "2k",
"creativity": 3,
"output_format": "jpeg"
}
Elegir un acabado
preset | Dirección visual |
|---|---|
bloom_2 | Modelo creativo más reciente y predeterminado |
bloom | Ilustración, arte y CG |
bloom_realism | Acabado fotográfico natural; creatividad limitada a 1–4 |
Prueba de retrato
Sin prompt y con creatividad 3, Bloom 2 reconstruyó ojos, barba y textura de piel. La imagen derecha interpreta la cara; no demuestra qué detalle había capturado la cámara.
De izquierda a derecha: Bloom 2, Bloom Realism y Bloom. Bloom 2 presenta más textura; Realism define la cara con cambios leves de parecido; Bloom queda más suave en esta prueba. Tardaron unos 86, 134 y 273 segundos.
Límites creativos
Bloom inventa detalles y puede alterar rostros, texturas y objetos pequeños. creativity acepta enteros de 1–9, pero bloom_realism solo permite 1–4; valores mayores se rechazan. El tiempo varía según la imagen y el preset.
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": "topaz/bloom/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"preset": "bloom_2",
"resolution": "4k"
}
}'
# 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.
