Introduction
Krea 3 Édition d’image modifie ou combine de une à huit images sources à partir d’une consigne en langage courant. Krea a conçu Krea 3 d’abord pour les éditions : dites ce qui doit changer et ce qui doit rester, et désignez les sources par image 1, image 2 et ainsi de suite. Vous fixez la forme de sortie ; chaque résultat fait environ un mégapixel.
Choisir un mode selon le point de départ
| Ce que vous avez | Mode |
|---|---|
| une description écrite | Krea 3 Texte vers image |
| une à huit photos à modifier ou combiner | Krea 3 Édition d’image |
Fonctionnalités et points forts
Combiner personnes, vêtements et lieux
Jusqu’à huit sources dans une même requête. Dans notre exemple, la femme de image 1 porte la robe à motifs cachemire de image 2 sur une terrasse de canyon, avec son visage et ses cheveux conservés.
Désigner les sources par leur numéro
"The person from image 2" choisit le second fichier : lors de notre contrôle avec une femme en image 1 et un homme en image 2, seul l’homme est apparu.
L’identité tient malgré les grands changements
Une femme en blazer de bureau est devenue un portrait des années 1970 dans un salon lambrissé de bois, avec le même visage, les mêmes tresses et le même cadrage.
Uniquement du contenu de niveau mode
Les requêtes et les sources sont filtrées. Les changements de tenue et de décor passent ; les demandes de retrait des vêtements sont refusées et non facturées.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Dites ce qu’il faut changer, puis ce qui reste. Désignez les sources par image 1, image 2 dans l’ordre d’import. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | De une à huit images, dans l’ordre où le prompt les nomme. Chacune ajoute de nouveau le prix de sortie. 1 éléments minimum · 8 éléments maximum |
aspect_ratio | Non | Forme de la sortie : 1:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9 ou 21:9. Par défaut 1:1 ; la forme de la source n’est pas conservée automatiquement. |
quality | Non | high (par défaut) privilégie le détail ; fast répond plus vite. Même prix. |
enable_thinking | Non | Planifie un prompt plus long avant le rendu ; environ deux fois plus lent lors de nos tests. Désactivé par défaut. Valeur par défaut: |
negative_prompt | Non | Ce qu’il faut écarter, jusqu’à 1 024 caractères. Utilisé uniquement par la variante haute qualité. 1024 caractères maximum |
output_format | Non | PNG (par défaut) ou JPEG. Sans effet sur le prix. |
seed | Non | Facultatif, de 0 à 2147483647. Réutiliser un seed vous rapproche d’une image précédente sans garantir une correspondance. |
Tarification
$0.072 / image
Facturation par image : un prix de sortie, plus le même montant pour chaque image source. La variante de qualité, la réflexion et le ratio ne changent pas le prix. Les requêtes refusées ne sont pas facturées.
Cas d’utilisation
Essayage virtuel et stylisme
Un portrait plus la photo d’un vêtement devient une prise de vue stylisée de cette personne portant le vêtement.
Remise en scène et looks d’époque
Déplacez un sujet dans un nouveau lieu, une autre époque ou une autre lumière tout en conservant son identité.
Guide de prompt et conseils pratiques
Commencez par la modification
Commencez par ce qui doit changer, puis une phrase sur ce qui reste. Pour plusieurs sources, nommez chacune : "the woman from image 1", "the dress from image 2".
Choisissez la forme de sortie
Le résultat suit le ratio d’image que vous choisissez et non la forme de la source. Adoptez le ratio de la photo principale pour éviter un recadrage non voulu.
Surveillez le nombre de sources
Chaque image source est facturée en plus de la sortie ; n’envoyez que celles que le prompt utilise. Indiquez l’âge des personnes lorsque vous changez leur époque ou leur style : le rendu peut vieillir ou rajeunir.
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": "krea/3/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "high"
}
}'
# 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.
