Black Forest Labs

FLUX.2

flux-2/text-to-image

La famille de génération et d'édition d'images de Black Forest Labs, prenant en charge le transfert de style à partir d'images de référence et la fusion de plusieurs images de référence, tout en préservant autant que possible la composition d'origine et la position du sujet lors de l'édition

flux-2/image-to-image flux-2/text-to-image

Essayer flux-2/text-to-image

Entrée

Créations

Voir toutes les créations

Sortie

image

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

flux-2/text-to-image per image

Spécifications	Prix unitaire
0.5 MP	$0.0375
1 MP	$0.050
2 MP	$0.075
4 MP	$0.125

Positionnement

FLUX.2 texte-vers-image est la voie de génération uniquement à partir de texte du modèle de génération d'images lancé par Black Forest Labs, appelée via l'interface unifiée de HiAPI.ai. Il reçoit une invite textuelle, produit des images de style photoréaliste et expose des contrôles de paramètres tels que la résolution, le rapport d'image, le format et la qualité de sortie, ainsi que la graine aléatoire, ce qui le rend adapté à l'exploration de concepts créatifs et à la production visuelle en lot nécessitant des images stables et reproductibles.

Points clés

Résolution et rapport d'image configurables à la demande — prise en charge de résolutions de sortie de 0,5 à 4 MP et de plusieurs rapports d'image courants, avec possibilité de définir une largeur et une hauteur personnalisées afin de choisir la netteté et la composition selon l'usage.
Génération reproductible grâce à la graine aléatoire — définir seed permet de répéter le même résultat, facilitant la comparaison de paramètres et le retour arrière de versions sur une même composition.
Paramètres de livraison de sortie contrôlables — formats webp, jpg et png disponibles avec réglage de la qualité de compression, pour produire directement des fichiers image prêts à être distribués.
Tolérance de sécurité ajustable — safety_tolerance offre une plage de 1 à 5, permettant d'ajuster la sévérité du filtrage selon les exigences de conformité métier.

Description des capacités

Génération d'images photoréalistes à partir de texte : il suffit de saisir une invite textuelle pour générer une image ; les sources officielles et tierces positionnent principalement ce modèle sur le style photoréaliste, utilisable pour la conception visuelle et la production d'assets.

Contrôle du rapport d'image et de la résolution : via aspect_ratio, choisissez un ratio prédéfini ou des dimensions personnalisées, combiné à un paramètre de résolution de 0,5 à 4 MP, pour s'adapter aux compositions horizontales ou verticales et aux différents emplacements d'affichage.

Réglage du format et de la qualité de sortie : prise en charge de trois formats de sortie webp, jpg et png, avec une qualité d'enregistrement réglable de 0 à 100, pour équilibrer poids du fichier et qualité d'image selon l'usage du produit.

Génération reproductible : après avoir spécifié seed, la même invite et la même combinaison de paramètres produisent un résultat identique, ce qui facilite l'identification de l'origine des changements lors des itérations.

Réglage du filtrage de sécurité : le paramètre safety_tolerance offre cinq niveaux, du plus strict au plus permissif, à définir selon le niveau de conformité du scénario de mise en production.

Cas d'usage

Croquis conceptuels pour équipes créatives — produire rapidement plusieurs versions de brouillons visuels à partir d'invites courtes, pour le tri des directions et la revue interne, avant de décider des éléments à affiner.
Exploration de compositions en design et publicité — générer des visuels horizontaux et verticaux en combinant rapport d'image et paramètres de résolution, directement utilisables pour les propositions et les prémaquettes de mise en page.
Flux de production d'assets en lot — générer en lot des assets image aux spécifications uniformes dans des flux automatisés, grâce à une graine fixe et à des paramètres de format de sortie.
Références visuelles de style photoréaliste — générer des scènes photoréalistes ou des visuels d'ambiance produit, servant de références avant photographie, mise en scène ou rendu.

Limites et conseils de choix

Cette voie n'accepte que des invites textuelles et ne traite pas d'images de référence ; pour éditer ou transférer le style d'une image existante, il faut utiliser la voie image-vers-image de la même famille. La résolution est prise en charge jusqu'à 4 MP, mais la documentation des paramètres recommande 2 MP ou moins ; pour les sorties de très grande taille, il convient d'évaluer soi-même le gain de qualité. Le filtrage de sécurité s'applique par niveau, et les niveaux plus stricts peuvent affecter la visibilité du contenu généré. Les licences non commerciales et les exigences de déploiement matériel mentionnées dans les documents de recherche dépendent du mode d'obtention réel du modèle par l'utilisateur ; lors d'un appel via HiAPI.ai, ces contraintes d'auto-hébergement peuvent être ignorées.

Nouveautés

Voir le journal des modifications →

Nouveau modèle Nouveau modèle : flux-2-klein-4b/text-to-image, génération d'images à partir de texte à haut rapport qualité-prix avec des paliers de 0,25 à 4 MP ; avec… Jul 27, 2026
Nouveau modèle Nouveau modèle d'édition d'image : flux-2-klein-4b/image-to-image prend en charge une seule image de référence et des sorties de 0,25 à 4 MP… Jul 27, 2026

Questions fréquentes

Voir toutes les questions →

Combien d'images de référence l'édition d'images FLUX.2 prend-elle en charge ?

Elle prend en charge de 1 à 8 images de référence JPEG, PNG ou WebP, chacune ne dépassant pas 10 Mo. Lors d'une composition multi-images, il convient de préciser dans le Prompt le rôle de chaque image, dans l'ordre.
À quoi sert le format auto ?

auto suit le rapport largeur-hauteur de la première image de référence ; pour une sortie fixe en paysage, portrait ou carré, choisissez un format explicite.
Comment la facturation s'effectue-t-elle pour 1K et 2K ?

1K et 2K utilisent des tarifs unitaires différents par image, le nombre d'images de référence n'entraîne pas de surcoût ; les montants exacts sont ceux du tarif en temps réel indiqué sur cette page.
Comment réduire la dérive du sujet et du logo ?

Indiquez explicitement l'usage de chaque image de référence et énumérez à la fois les éléments du sujet, du texte, de la matière, de la position et de la lumière à modifier et ceux à conserver impérativement.

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le 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-KeystringOptionnel

Clé 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.

Clé d'idempotence

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

modelstringRequis

Valeur fixe actuelle : flux-2/text-to-image

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour flux-2/text-to-image et la route default — voir le tableau des paramètres ci-dessous.

seedintegerOptionnel

Graine aléatoire, utilisée pour reproduire les résultats de génération ; définir la même graine permet d'obtenir une sortie de génération reproductible.

widthintegerOptionnelmin 256max 2048

Largeur d'image personnalisée, effective uniquement lorsque aspect_ratio est défini sur custom, arrondie automatiquement au multiple de 16 le plus proche.

heightintegerOptionnelmin 256max 2048

Hauteur d'image personnalisée, effective uniquement lorsque aspect_ratio est défini sur custom, arrondie automatiquement au multiple de 16 le plus proche.

promptstringRequis

Prompt texte utilisé pour la génération d'image, décrivant le contenu visuel souhaité.

resolutionstringOptionnelDéfaut: "1 MP"

Résolution en mégapixels (MP) de l'image de sortie, jusqu'à 4 MP pris en charge, il est recommandé d'utiliser 2 MP ou moins. Par défaut 1 MP.

Options：0.5 MP1 MP2 MP4 MP

aspect_ratiostringOptionnelDéfaut: "1:1"

Rapport largeur-hauteur de l'image générée. Par défaut 1:1.

Options：1:116:93:22:34:55:49:163:4

Tout afficher (2)

4:3custom

output_formatstringOptionnelDéfaut: "webp"

Format d'enregistrement de l'image de sortie. Par défaut webp.

Options：webpjpgpng

output_qualityintegerOptionnelDéfaut: 80min 0max 100

Qualité d'enregistrement de l'image de sortie, valeur comprise entre 0 et 100 ; sans effet pour le format png. Par défaut 80.

safety_toleranceintegerOptionnelDéfaut: 2min 1max 5

Tolérance de sécurité, 1 étant le plus strict et 5 le plus permissif. Par défaut 2.

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

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.

urlstringRequis

Obligatoire 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.

Options：final

storagestringOptionnelDé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.

Options：temppersistent

Exemples 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/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "1 MP",
    "aspect_ratio": "1:1",
    "output_format": "webp",
    "output_quality": 80,
    "safety_tolerance": 2
  }
}'

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/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "1 MP",
      "aspect_ratio": "1:1",
      "output_format": "webp",
      "output_quality": 80,
      "safety_tolerance": 2
    }
  }),
});
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/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "1 MP",
          "aspect_ratio": "1:1",
          "output_format": "webp",
          "output_quality": 80,
          "safety_tolerance": 2
        }
    },
)
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

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom 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.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

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.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes 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

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description 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"
    }
  }
}