Introducción
P-H3-Image Edición de imagen toma la primera imagen como origen y admite hasta ocho imágenes de referencia adicionales. Una instrucción de texto indica al modelo qué elementos conservar o reemplazar.
Funciones y aspectos destacados
Identifica la imagen de origen como <Picture 1> y la siguiente entrada como <Picture 2>. La forma de salida sigue por defecto a la primera imagen; seleccionar aspect_ratio la sustituye. Los cinco niveles de resolución están disponibles para edición. En nuestras pruebas, una edición en 4k devolvió 3360 x 5024 píxeles.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Proporciona la instrucción de edición obligatoria, sin un texto predeterminado. Indica el cambio y lo que debe mantenerse, usando imágenes numeradas al combinar fuentes. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | Lista ordenada obligatoria de 1–9 URL de imágenes, sin una imagen de origen predeterminada. mínimo 1 elementos · máximo 9 elementos |
aspect_ratio | No | Omite este campo opcional para heredar la relación de aspecto de la primera imagen. |
resolution | No | La edición usa por defecto 1k, alrededor de 1 megapíxel. |
output_format | No | La edición se guarda como jpeg salvo que solicites png o webp. Las tres codificaciones tienen el mismo precio. |
seed | No | Puedes indicar un valor de fuente aleatoria para comparar ediciones; por defecto no se exige ninguno. |
Precios
El resultado editado tiene un cargo por imagen según el nivel: 1k, 1.5k, 2k, 3k o 4k. Cada imagen de entrada después de la primera agrega un pequeño cargo; la proporción y la codificación de salida no agregan ninguno. Una solicitud fallida no se cobra.
| Especificación | Precio |
|---|---|
| $0.03 / imagen |
| $0.048 / imagen |
| $0.066 / imagen |
| $0.138 / imagen |
| $0.21 / imagen |
Casos de uso
Usa un retrato para cambiar el vestuario y situarlo junto al mar, o combina una fotografía de un escenario con una persona que reemplace al artista. Nuestras pruebas con una y dos fuentes conservaron la identidad solicitada a través de los cambios de escena.
Guía de prompts y consejos prácticos
Coloca primero la escena que quieras mantener y luego explica qué detalles aporta cada entrada numerada. Al invertir ese orden, nuestras pruebas dieron un resultado más cercano a la otra escena. Cada referencia adicional a la primera suma un pequeño cargo. Según Pruna AI, las resoluciones inferiores pueden mostrar más defectos en los detalles.
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": "pruna-ai/p-h3-image/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.
