Introduction
FLUX 3 Klein Base texte vers image génère une image à partir d’un prompt écrit sur le FLUX 3 Image Klein Base de Black Forest Labs, le point de contrôle non distillé à poids ouverts de 5,6 milliards de paramètres publié le 15 octobre 2026. Ses créateurs font tourner Base en 50 étapes d’échantillonnage contre 16 pour le Klein distillé, donc chaque image prend plus de temps. Choisissez l’un des quinze formats aux tailles 1k ou 2k, en JPEG, PNG ou WebP. La plateforme n’ajoute pas de filtre propre, mais cette variante adoucit souvent les prompts les plus forts ; pour ceux-ci, utilisez le FLUX 3 Klein distillé.
Choisir un mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| une description écrite | FLUX 3 Klein Base Texte vers image |
| une à trois images à modifier ou combiner | FLUX 3 Klein Base Retouche d’image |
Fonctionnalités et points forts
Échantillonnage complet, lumière naturelle
Sans aucun raccourci d’échantillonnage, Base a dessiné dans nos tests une peau douce et crédible, et a bien mélangé la lumière : jour bleu froid à travers des planches de pin face à une lueur ambrée de poêle, cheveux mouillés, textures de laine et de lin. Il convient aux images que vous regarderez de près plutôt qu’aux brouillons rapides, et le palier 2k offre environ quatre mégapixels à recadrer.
Quinze formes
Tous les ratios de 3:1 à 1:3 sont disponibles, dont 21:9, 4:5 et 2:1, et chacun est revenu à sa taille native dans nos tests, de 1760 x 576 à 576 x 1760 en 1k. Bannières, affiches et écrans de téléphone sortent du modèle sans recadrage.
Seeds reproductibles
Une seed répétée avec les mêmes entrées a renvoyé des pixels identiques dans nos tests. Changez une phrase à la fois et chaque différence observée vient de ce changement, ce qui rend le travail sur un modèle lent beaucoup moins aléatoire.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire, jusqu’à 5 000 caractères. Rédigez une légende complète : cadrage, sujet, vêtements, décor, lumière et objectif. 1 caractères minimum · 5000 caractères maximum |
aspect_ratio | Non | Quinze formes, de 3:1 à 1:3 ; 1:1 par défaut. Avec |
resolution | Non | 1k (par défaut) fait environ un mégapixel ; le 2k fait environ quatre mégapixels, par exemple 2720 x 1536 pour une image large. |
output_format | Non | JPEG (par défaut), PNG ou WebP. Ne change pas le prix. |
seed | Non | Facultatif, de 0 à 2 147 483 647. Dans nos tests, la même seed et les mêmes entrées ont renvoyé des pixels identiques, ce qui isole l’effet d’un seul changement. |
Tarification
Facturé à l’image. Le 2k coûte environ quatre fois le 1k ; le ratio et le format de sortie ne changent pas le prix.
| Spécification | Prix |
|---|---|
| $0.036 / image |
| $0.144 / image |
Cas d’utilisation
Portraits et intérieurs éditoriaux
Salons de sauna, cabanes, ateliers et intérieurs éclairés à la lampe, avec lumière et tissus en couches, quand vous voulez que le modèle prenne son temps sur la peau et la texture et que vous pouvez attendre une trentaine de secondes par image.
Avant un fine-tuning
Base est le point de contrôle que Black Forest Labs publie pour le fine-tuning. Voyez comment il dessine votre sujet et votre style à partir d’un prompt, avant de décider si un LoRA ou un fine-tuning complet vaut la peine d’être entraîné.
Guide de prompt et conseils pratiques
Écrivez des légendes, pas des mots-clés
Klein est entraîné sur de longues légendes de scène, et Black Forest Labs réécrit normalement les prompts courts avant la génération. Ce point de terminaison envoie vos mots tels quels : décrivez cadrage, sujet, vêtements, lieu, lumière, objectif et étalonnage en phrases complètes.
Nommez chaque vêtement
Pour les demandes plus fortes, le modèle fait ses propres choix de tenue. Concentrez plutôt vos mots sur le décor, la lumière et l’objectif, et laissez une image de référence porter la tenue lorsque cela compte.
Brouillon en 1k, finition en 2k
Le 1k prend environ 14 à 45 secondes et coûte un quart du 2k. Fixez le prompt et la seed en 1k, puis rendez l’image retenue en 2k pour environ quatre mégapixels.
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": "black-forest-labs/flux-3-klein-base/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 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.
