Introduction
Krea 3 Texte vers image dessine une image à partir d’une consigne en langage courant, avec Krea 3, le modèle d’image maison que Krea a conçu d’abord pour les éditions guidées par consigne. Choisissez l’un des dix ratios d’image pour environ un mégapixel, puis la variante haute qualité ou rapide ; les deux coûtent le même prix.
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
Rendu photographique façon pellicule
Lors de nos tests, Krea 3 a rendu peau, tissus et lumière de fin de journée comme un négatif argentique numérisé : grain, halo et dominantes de couleur crédibles sont venus d’une courte ligne de style placée à la fin du prompt.
Dix formats, un seul prix
De 21:9 à 9:16, chacun d’environ un mégapixel et généré à cette taille. Chaque format proposé a été vérifié par une vraie requête, et la forme ne change jamais le prix.
Un commutateur de réflexion sans surcoût
Activez enable_thinking et le modèle planifie un prompt plus long avant de dessiner. Lors de nos tests, l’attente a à peu près doublé (environ 30 secondes), sans changer le prix.
Uniquement du contenu de niveau mode
Les requêtes sont filtrées avant le rendu. Les tenues de niveau Léger sont rendues ; les prompts à partir du niveau Modéré ont été refusés en environ deux secondes et ne sont pas facturés.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Décrivez l’image en phrases : qui, ce qu’il porte, où, la lumière, puis une ligne de pellicule ou de couleur. Jusqu’à 5 000 caractères. 1 caractères minimum · 5000 caractères 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. |
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.036 / image
Un prix forfaitaire par image. Le ratio d’image, la variante de qualité et la réflexion ne changent pas le prix. Les requêtes refusées ne sont pas facturées.
Cas d’utilisation
Photos éditoriales et lookbook
Mode d’époque, intérieurs et portraits au rendu photographique, prêts pour une planche d’ambiance ou un projet de campagne.
Bannières larges et visuels verticaux
En-têtes 21:9 et cadres verticaux 9:16 à partir du même prompt, au même prix.
Guide de prompt et conseils pratiques
Écrivez-le comme un plan de tournage
Qui, ce qu’il porte, où il se trouve, la lumière, puis une ligne de pellicule et d’étalonnage. Krea 3 lit bien les phrases complètes.
Brouillon rapide, finition en haute qualité
Utilisez la variante rapide pour trouver le cadrage, puis passez à la haute qualité pour la version retenue. Réutiliser un seed vous rapproche de la même image, sans garantie de correspondance exacte.
Gardez un prompt négatif court
negative_prompt ne s’applique qu’à la variante haute qualité. Quelques mots comme « text, watermark » suffisent.
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "high",
"aspect_ratio": "1:1",
"output_format": "png"
}
}'
# 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.
