Black Forest Labs: FLUX.3 Image
FLUX 3 Image crée et monte des images à partir d’un brief écrit et d’un maximum de dix références. Il ajoute des boîtes englobantes définies par prompt pour la composition et les changements locaux, l’ancrage dans les recherches Web et d’images, ainsi que cinq classes de résolution.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
FLUX 3 Image est le modèle de génération et de montage d’images de Black Forest Labs avec contrôle explicite de la composition. Une description textuelle peut créer une nouvelle scène; des images fournies peuvent établir un sujet, une scène à réviser ou plusieurs éléments à combiner. Les boîtes englobantes permettent à un brief de préciser l’emplacement de chaque élément et les parties d’une image existante à modifier. Le résultat est une image, avec la scène, le texte et la mise en page demandés à inspecter.
Créer une scène ou donner une instruction de montage
Pour une nouvelle image, décrivez le sujet, l’action ou la pose, le décor, la lumière et le cadrage. Placez le texte exact à afficher dans l’image entre guillemets et indiquez où il apparaît. Un brief de produit original pourrait montrer une tasse de camping rouge sur une surface en pierre claire, avec un grand titre au-dessus et une lumière matinale douce révélant l’anse. Définissez la relation entre le titre, le produit et l’arrière-plan au lieu de fournir des mots de style sans lien.
Pour le montage, identifiez l’objet précis et la modification : recolorer la tasse, remplacer une étiquette, déplacer une silhouette ou changer le style de la scène. Un montage unique ne nécessite pas de boîte dessinée manuellement. Le processus documenté enrichit l’instruction avant la génération et peut repérer l’élément nommé et ajouter une boîte automatiquement. Le prompt enrichi renvoyé consigne cette interprétation, ce qui est utile lorsqu’une instruction sélectionne le mauvais objet ou introduit un détail indésirable.
Combiner et préparer les images de référence
Le profil exact du producteur accepte d’une à dix références, fournies sous forme d’URL d’images ou de données d’image encodées. Chacune doit mesurer au moins 256×256 pixels et ne pas dépasser 16 mégapixels. Nommez une référence selon sa position ou son contenu visible, puis expliquez son rôle : la personne d’Image 1, la veste d’Image 2 et la pièce d’Image 3. Une image de référence est une source d’information visuelle, et non une instruction de copier chaque détail sans rapport qu’elle contient.
Le réglage du ratio est auto par défaut. Dans la spécification de requête, un ratio demandé dans le prompt a priorité; sinon, la première référence établit le cadrage, avec une sortie carrée de repli lorsqu’aucune référence ni aucun format demandé ne le définit. Pour une composition, placez la référence de scène voulue en premier ou choisissez le ratio explicitement. Conservez les images sources et leur ordre avec le résultat pour qu’une révision ultérieure utilise le même point de départ visuel.
Placer les éléments avec des boîtes englobantes
Un prompt de mise en page combine une légende avec un tableau JSON de lignes d’éléments. La légende nomme un élément au moyen d’un marqueur comme <cup_1>; la ligne contient id, bbox et desc. Les coordonnées sont des entiers de 0 à 1000 dans l’ordre [haut, gauche, bas, droite], mesurés depuis le coin supérieur gauche. Par exemple, [0, 0, 500, 500] décrit le quart supérieur gauche, peu importe les dimensions de l’image en pixels. Utilisez le ratio pour lequel la mise en page a été conçue, car cette grille de coordonnées s’étire avec le cadre.
Une ligne de montage utilise plutôt from, src_bbox et tgt_bbox avec l’identifiant et la description. ref_image_0 désigne la première image fournie. Des boîtes source et cible identiques ancrent un élément; des boîtes différentes le déplacent ou le redimensionnent. Une nouvelle ligne sans source génère sa description à l’emplacement cible, permettant les ajouts, remplacements ou recolorations. Une ligne source sans cible retire l’élément. Indiquez les ajouts et retraits dans l’instruction écrite et dans les lignes, et conservez les lignes d’ancrage des détails qui doivent rester en place.
Donnez au texte sa propre boîte et citez sa formulation exacte dans desc. Les boîtes guident le placement et l’échelle; ce ne sont pas des masques de découpage, donc un élément peut dépasser le rectangle. Le fabricant rapporte que de nouveaux objets dans des boîtes d’environ 40×25 pixels n’apparaissaient souvent pas dans ses exemples. Prévoyez assez d’espace visible et inspectez les limites modifiées. Les pixels à l’extérieur de la cible restent généralement stables, mais les ombres, les reflets et l’éclairage à proximité peuvent quand même changer.
Ancrage, classes de sortie et dossiers utiles
Le profil documenté active l’ancrage par défaut, permettant à la recherche Web et d’images d’informer la génération. Il peut être désactivé pour un brief qui doit utiliser seulement la description et les références fournies. Pour un sujet du monde réel, identifiez clairement le lieu, l’événement ou l’objet et gardez le contenu factuel distinct du traitement artistique. Une image informée par la recherche doit tout de même être comparée à des sources faisant autorité lorsqu’une étiquette, un objet ou un événement représenté doit être exact.
Les cinq classes de résolution sont 768sq, 1k, 1.5k, 2k et 4k, avec 1k par défaut. Elles représentent des paliers de surface égale en pixels : la largeur et la hauteur exactes dépendent donc du ratio choisi. Quinze ratios fixes vont de 21:9, en passant par les formats carré et portrait, à 9:21. Le profil de ce modèle contrôle la taille par le ratio et la résolution; il n’expose pas les champs seed, width ou height utilisés dans les profils de requête FLUX.2. Son sélecteur de version documenté nomme actuellement une version évolutive plutôt que d’établir une correspondance datée avec les poids du fournisseur.
Le processus du producteur renvoie une image après un traitement asynchrone, ainsi que le prompt enrichi. Son lien signé de téléchargement d’image est valide pendant une heure. Conservez l’image réelle, le prompt final et les références au lieu de compter sur un lien temporaire. Pour une ressource vérifiée, comparez le texte demandé, le placement des objets, l’identité des références et la zone modifiée à la taille d’affichage prévue. Une génération terminée est le point de départ de la vérification de ces exigences visuelles.
Ailoot Ultra · Génération d’images POST /v1/images/generations black-forest-labs/flux-3-image
black-forest-labs/flux-3-image
black-forest-labs/flux-3-imagePour commencer
FLUX 3 Image crée et monte des images à partir d’un brief écrit et d’un maximum de dix références. Il ajoute des boîtes englobantes définies par prompt pour la composition et les changements locaux, l’ancrage dans les recherches Web et d’images, ainsi que cinq classes de résolution.
- Entrées acceptées
- Texte · Images
- Résultats
- Images
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Génération d’images POST /v1/images/generations
- Entrée
text,image- Sortie
image
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites black-forest-labs/flux-3-image | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— |
Champresolution | Typestring | ExigenceFacultatif | Valeurs et limites 768, 1K, 1.5K, 2K, 4K | Par défaut— |
Champaspect_ratio | Typestring | ExigenceFacultatif | Valeurs et limites 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto | Par défaut— |
Champn | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 1 Maximum: 1 | Par défaut— |
Champinput_references | Typearray | ExigenceFacultatif | Valeurs et limites Nombre minimal d’éléments: 0 Nombre maximal d’éléments: 10 | Par défaut— |
Champprovider | Typeobject | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt |
Paramètrematerial_types | Contrattext, image |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effectivement renvoyé ou enregistrement de la bibliothèque multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarifs
Calcul du coût final
Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs estimés à des fins de comparaison
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Coût |
|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Coût Entrée · Jetons en entrée · Estimation à des fins de comparaison uniquement — / 1K jetons Sortie · Jetons en sortie · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K jetons |
| ConfigurationCoût de génération estimé | Barème tarifaire— | Quantité prévisionnelleestimation pour une génération | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.082 estimation avant génération Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée. |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
Ailoot Ultra · Génération d’images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'black-forest-labs/flux-3-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Recevoir et enregistrer les résultats
Ailoot Ultra · Génération d’images
Téléchargez chaque image renvoyée ou enregistrez son contenu Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Autres lectures de contenu
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Conserver tous les résultats terminés
Enregistrez chaque image terminée ; récupérez chaque URL renvoyée ou décodez son contenu Base64.
Conservez la réponse complète et les en-têtes, chaque sortie effective, les identifiants initialement renvoyés et tous les champs d’utilisation. Récupérez l’opération d’origine sans soumettre à nouveau sa création.
Si la réponse d’origine doit être vérifiée
Conservez le X-Client-Request-ID renvoyé pour le rapprochement. Consultez uniquement les valeurs task_id/asset_id effectivement renvoyées ou votre bibliothèque multimédia ; ne construisez jamais une URL de tâche à partir de l’identifiant de l’opération et ne soumettez jamais à nouveau la création.
Champs de la réponse
| Champ | Type |
|---|---|
Champcreated | Type |
Champdata[].url | Type |
Champdata[].b64_json | Type |
Champusage | Type |
Alias
Alias du modèle
Ailoot Ultra black-forest-labs/flux-3-image
Alias des chemins de méthode
/v1/images
ID d’appel associés
FAQ · Black Forest Labs: FLUX.3 Image
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/images/generations·black-forest-labs/flux-3-image:text,image→image- Quels champs la requête utilise-t-elle ?
POST /v1/images/generations·black-forest-labs/flux-3-image:model,prompt,resolution,aspect_ratio,n,input_references,provider- Quelles limites s’appliquent ?
POST /v1/images/generations·black-forest-labs/flux-3-image:n.minimum:1;n.maximum:1