Introduction
P-H3-Image Retouche d’image prend la première image comme source et accepte jusqu’à huit images de référence supplémentaires. Une instruction textuelle indique au modèle les éléments à conserver ou à remplacer.
Fonctionnalités et points forts
Désignez la source par <Picture 1> et l’entrée suivante par <Picture 2>. Par défaut, la forme de sortie suit la première image ; choisir aspect_ratio permet de la remplacer. Les cinq paliers de résolution sont disponibles en retouche. Dans nos tests, une retouche 4k a renvoyé 3360 x 5024 pixels.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Fournissez l’instruction de retouche obligatoire, sans texte par défaut. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | Liste ordonnée obligatoire de 1–9 URL d’images, sans source par défaut. 1 éléments minimum · 9 éléments maximum |
aspect_ratio | Non | Omettez ce champ facultatif pour reprendre le ratio de la première image. |
resolution | Non | La retouche utilise par défaut le 1k, soit environ 1 mégapixel. |
output_format | Non | Enregistrez la retouche en jpeg, sauf si vous demandez png ou webp. Ces trois encodages sont proposés au même tarif. |
seed | Non | Vous pouvez fournir une valeur de source aléatoire pour comparer des retouches ; aucune n’est requise par défaut. |
Tarification
La retouche est facturée par image selon le palier 1k, 1.5k, 2k, 3k ou 4k. Chaque image en entrée après la première ajoute un petit supplément ; le ratio et l’encodage de sortie n’en ajoutent aucun. Une requête en échec n’est pas facturée.
| Spécification | Prix |
|---|---|
| $0.03 / image |
| $0.048 / image |
| $0.066 / image |
| $0.138 / image |
| $0.21 / image |
Cas d’utilisation
Utilisez un portrait pour changer la tenue et placer la personne au bord de la mer, ou associez une photo de scène à une personne de remplacement. Nos tests avec une ou deux sources ont conservé l’identité demandée malgré les changements de scène.
Guide de prompt et conseils pratiques
Placez la scène à conserver en première position, puis indiquez les détails à reprendre de chaque entrée numérotée. Dans nos tests, inverser cet ordre a donné un résultat plus proche de l’autre scène. Chaque référence après la première entraîne un petit supplément. Selon Pruna AI, les résolutions inférieures peuvent présenter davantage d’artefacts dans les détails.
Démarrage rapide de l’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"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
