Black Forest Labs
FLUX.2 Klein 4B
flux-2-klein-4b/text-to-image
Petit modèle distillé de 4 milliards de paramètres, unifiant la génération d'images à partir de texte et l'édition d'images, avec une inférence de bout en bout pouvant descendre sous 1 seconde, exécutable avec environ 13 Go de mémoire GPU
Essayer flux-2-klein-4b/text-to-image
Entrée
Créations
Voir toutes les créationsSortie
imageTarifs
flux-2-klein-4b/text-to-image per image
| Spécifications | Prix unitaire |
|---|---|
| 0.25 MP | $0.00036 |
| 0.5 MP | $0.00072 |
| 1 MP | $0.00143 |
| 2 MP | $0.00286 |
| 4 MP | $0.00572 |
Présentation du positionnement
FLUX.2 klein 4B est un modèle compact de génération d'images à partir de texte lancé par Black Forest Labs, fondé sur une architecture rectified flow de 4 milliards de paramètres, qui hérite par distillation de la compréhension de l'éclairage, des matières et de la composition du socle FLUX.2 plus vaste. Il s'adresse aux développeurs ayant besoin de générer des images en lot à faible coût et de s'intégrer de manière fiable dans des workflows interactifs ou sensibles à la latence. Grâce à l'interface unifiée de HiAPI.ai, il suffit de soumettre un prompt pour obtenir une image finale à la résolution et au rapport d'aspect souhaités.
Points clés
- Encombrement réduit, coût de génération maîtrisé — une échelle de 4 milliards de paramètres associée à une accélération par distillation, pour un coût de génération par image faible, adapté aux scénarios de développement nécessitant de grands volumes et de nombreux essais successifs.
- Distillé d'un socle FLUX.2 plus vaste — la compréhension de l'éclairage, des matières et de la composition provient de la distillation du grand modèle, avec une qualité supérieure à ce que laisse attendre son volume de paramètres.
- Spécifications de l'image fixées en un seul appel — la résolution, le rapport d'aspect, le format de sortie et la qualité de compression sont tous des paramètres de requête : les caractéristiques de l'image sont déterminées en un seul appel.
- Graine reproductible — la prise en charge d'une graine aléatoire permet de reproduire ou d'ajuster finement le résultat pour un même prompt, ce qui facilite le débogage et la validation de non-régression.
Description des capacités
Génération d'images à partir de texte : il suffit de soumettre un prompt textuel pour obtenir l'image correspondante, sans image de référence ; le prompt est le seul paramètre obligatoire, ce qui réduit le coût d'intégration.
Plusieurs paliers de résolution et rapports d'aspect : la sortie prend en charge cinq paliers de résolution de 0,25 à 4 MP, ainsi qu'une dizaine de rapports d'aspect comme 1:1, 16:9 et 21:9, directement adaptés aux besoins de mise en page tels que les images d'en-tête et les visuels verticaux.
Format de sortie et contrôle de la qualité : trois formats au choix — webp, jpg et png — avec un réglage de la qualité de compression de 0 à 100 pour jpg/webp, permettant d'arbitrer selon les besoins entre netteté et taille de fichier.
Graine aléatoire reproductible : le paramètre seed permet d'obtenir des résultats reproductibles pour des entrées identiques, ce qui facilite la comparaison de différentes combinaisons de paramètres et la reproduction d'échantillons problématiques.
Scénarios d'application
- Génération d'images en lot pour les plateformes de contenu — les équipes opérationnelles ou les développeurs backend génèrent des images en lot à partir de prompts modèles, en spécifiant le rapport d'aspect et le format webp, pour une utilisation directe en illustration d'articles et en vignettes de listes.
- Aperçu instantané dans les outils de création interactifs — les applications de création convertissent en temps réel les saisies de l'utilisateur en images, avec un aperçu rapide en basse résolution puis une sortie finale en haute résolution après validation.
- Production d'images normalisées pour les supports marketing — selon le canal de diffusion, on choisit un ratio comme 16:9 ou 9:16 et la résolution cible, pour produire en un seul appel des bannières et visuels de couverture directement publiables.
- Réglage des paramètres et validation de non-régression des résultats — grâce à la graine et aux paramètres de qualité, réaliser des comparaisons A/B et constituer une bibliothèque de prompts et une base de référence qualité à partir d'échantillons reproductibles.
Limites et conseils de choix
Seule la génération d'images à partir de texte est prise en charge ; pour éditer une image existante ou imposer une image de référence, il convient de choisir la filière d'édition d'image. Le modèle est une version distillée de 4B, dont le plafond de capacités est limité par la taille des paramètres : sa stabilité sur les compositions complexes, les textes denses et les détails fins est inférieure à celle de modèles plus grands, et pour ces besoins de haute précision, il est recommandé de choisir des modèles de plus grande taille. La résolution et le rapport d'aspect sont des énumérations prédéfinies, sans prise en charge de tailles arbitraires. En l'absence actuelle de données de référence transversales indépendantes, il est conseillé de fonder le choix sur des tests réels avec ses propres prompts.
Questions fréquentes
Voir toutes les questions →-
À quelles tâches FLUX.2 [klein] 4B est-il adapté ?
Adapté aux brouillons en masse, aux concepts de produits, aux contenus pour les réseaux sociaux et aux itérations visuelles sensibles aux coûts. Lorsqu'un plus grand réalisme, du texte et des détails sont nécessaires, passez au 9B.
-
Comment choisir entre 0,25 MP et 4 MP ?
Pour les brouillons et les miniatures, utilisez d'abord 0,25 ou 0,5 MP ; pour les ressources web courantes, utilisez 1 MP ; lorsque vous avez besoin d'un rendu plus grand, choisissez 2 ou 4 MP. Le prix varie selon le palier de pixels.
-
Quels formats d'image sont pris en charge ?
Prise en charge des formats 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9 et 9:21.
-
Comment reproduire la même direction de composition ?
Fixez le Seed, le Prompt, le format, le palier de pixels et les paramètres de sortie ; ne modifiez qu'une seule variable pour comparer.
Créer une tâche de génération
https://api.hiapi.ai/v1/tasks En-têtes
AuthorizationstringRequisClé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API
Content-TypestringOptionnelLe corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.
Idempotency-KeystringOptionnelClé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.
En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.
Corps
modelstringRequisValeur fixe actuelle : flux-2-klein-4b/text-to-image
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour flux-2-klein-4b/text-to-image et la route default — voir le tableau des paramètres ci-dessous.
seedintegerOptionnelGraine aléatoire servant à contrôler la reproductibilité du résultat de génération ; une même graine avec une même entrée permet d'obtenir une sortie identique, sous forme de valeur entière.
promptstringRequisPrompt textuel utilisé pour la génération d'image, décrivant le contenu visuel souhaité, sous forme de chaîne de caractères.
resolutionstringOptionnelDéfaut: "1 MP"Dimensions de l'image de sortie, spécifiées en mégapixels (MP), 1 MP par défaut.
0.25 MP0.5 MP1 MP2 MP4 MPaspect_ratiostringOptionnelDéfaut: "1:1"Rapport largeur/hauteur de l'image générée, 1:1 par défaut.
1:116:99:163:22:34:33:45:4Tout afficher (3)
4:521:99:21output_formatstringOptionnelDéfaut: "jpg"Format de sortie de l'image générée, jpg par défaut.
webpjpgpngoutput_qualityintegerOptionnelDéfaut: 95min 0max 100Qualité de compression des sorties jpg et webp, 95 par défaut, sous forme de valeur entière.
callbackobjectOptionnel
Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.
Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.
urlstringRequisObligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.
whenstringOptionnelDéfaut: "final"Seul final est pris en charge pour l'instant — notifié sur success et fail.
finalstoragestringOptionnelDéfaut: "temp"Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.
temppersistentExemples de requête
# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2-klein-4b/text-to-image",
"input": {
"prompt": "…",
"resolution": "1 MP",
"aspect_ratio": "1:1",
"output_format": "jpg",
"output_quality": 95
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "flux-2-klein-4b/text-to-image",
input: {
"prompt": "…",
"resolution": "1 MP",
"aspect_ratio": "1:1",
"output_format": "jpg",
"output_quality": 95
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "flux-2-klein-4b/text-to-image",
"input": {
"prompt": "…",
"resolution": "1 MP",
"aspect_ratio": "1:1",
"output_format": "jpg",
"output_quality": 95
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtenir le détail de la tâche
https://api.hiapi.ai/v1/tasks/:id Champs de réponse
taskIdstringRequisIdentifiant de tâche, toujours préfixé tk-hiapi-.
modelstringRequisNom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.
routestringOptionnelPrésent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.
statusstringRequisStatut de la tâche.
queued En file, pas encore démarrée.
handling En cours de traitement.
archiving Traitement terminé, préparation des artefacts.
success Terminal : terminé, artefacts disponibles (output renvoyé).
fail Terminal : échec (error renvoyé).
Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.
creatednumberRequisDate de création de la tâche (secondes Unix).
completednumberRequisSecondes Unix de l'état terminal ; 0 tant que non terminal.
outputarrayOptionnel
Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).
Array [ object ]
Éléments du tableau
urlstringRequisURL de l'artefact, téléchargeable directement.
typestringRequisValeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.
expireAtnumberRequisSecondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.
errorobjectOptionnel
Présent uniquement si status == fail.
codestringRequisCode d'erreur métier.
messagestringRequisDescription de l'erreur.
Exemples de réponse
Succès
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En cours (non terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Échec
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articles
Voir tous les articles →-
Tutoriel
Comment appeler hailuo-2.3/text-to-video via l'API HiAPI : curl, Python et exemples de requêtes exécutables
-
Tutoriel
Comment appeler kling-4.0/image-to-video sur HiAPI : curl, Python et interrogation périodique
-
Tutoriel
recraft-v4.1-flash génération d'images texte-à-image en pratique : 5 scénarios métier à forte valeur et points d'intégration clés
À partir d'un coût de 0,01 $ par image, planifier le déploiement de la génération d'images dans de vrais contextes métier
-
Comparatif et évaluation
Comparatif horizontal de Recraft v4.1 Flash en génération d'images à partir de texte : guide de sélection et de migration pour les développeurs
Avec un coût de 0,01 $ par image et ses capacités de génération pure à partir de texte, déterminez s'il convient à votre pipeline de génération d'images
-
Tutoriel
Comment utiliser kling-4.0/text-to-video via l'API HiAPI : curl, Python et un exemple de requête fonctionnel
Guide pratique pour les développeurs : prompts cinématographiques, audio synchronisé, interrogation asynchrone et téléchargement des sorties
-
Comparatif et évaluation
Comparatif transversal de hailuo-2.3-fast/image-to-video : comment choisir un modèle image-to-video et les points clés de migration
-
Tutoriel
Utiliser Kandinsky 6.0 Pro texte-vers-vidéo sur HiAPI : tutoriel curl et Python
Démonstration pratique axée sur la requête : construire l'appel du prompt au clip vidéo, soumettre la requête, interroger l'état d'achèvement et télécharger le résultat
-
Tutoriel
Comment appeler hailuo-2.3-fast/image-to-video via l'API HiAPI : curl et Python en pratique
La première requête exploitable du palier image-vers-vidéo rapide et économique — de l'ID du modèle au téléchargement du MP4
-
Tutoriel
Tutoriel pour kandinsky-6.0-pro/image-to-video sur HiAPI : curl + Python
Lancer une requête image-vers-vidéo exploitable sur HiAPI : de l'envoi de la première image à l'interrogation asynchrone jusqu'au téléchargement final
Modèles associés
Voir tous les modèles →Même type
-
FLUX.2 Klein 9B Black Forest Labs $0.0086 /image -
FLUX 1.1 Pro Black Forest Labs $0.050 /image -
Recraft Creative Upscale Recraft $0.357 /image -
FLUX.1 Schnell Black Forest Labs $0.005 /image -
Grok Imagine Image 2.0 xAI $0.052 /image -
Grok Imagine Quality xAI $0.070 /image -
Ideogram V4 Ideogram $0.050 /image -
Imagen 4 Google $0.030 /image -
Wan 2.7 Image Alibaba $0.035 /image -
Recraft V4.1 Recraft $0.010 /image -
Ideogram V3 Character Ideogram $0.090 /image -
FLUX 3 Image Black Forest Labs $0.041 /image
Même fournisseur
-
FLUX 1.1 Pro Black Forest Labs $0.050 /image -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /image -
FLUX 3 Max Black Forest Labs $0.061 /seconde -
FLUX.2 Black Forest Labs $0.035 /image -
FLUX.1 Kontext Max Black Forest Labs $0.071 /image -
FLUX 3 Image Black Forest Labs $0.041 /image -
FLUX.1 Schnell Black Forest Labs $0.005 /image -
FLUX 3 Video Black Forest Labs $0.090 /seconde -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /image -
FLUX.1 Fill Pro Black Forest Labs $0.071 /image


