API FLUX 3 Image
FLUX 3 Image de Black Forest Labs pousse le contrôle génératif au niveau du pixel : placez chaque élément par boîtes englobantes, éditez zone par zone pendant que le reste reste identique au pixel près, et générez nativement de 768sq à 4K. Roko API le sert en tâche asynchrone dès 0,041 $ par requête 768sq.
- ID public du modèle
flux-3-image- Paliers de sortie
768sq / 1K / 1.5K / 2K / 4K (1K par défaut)- Facturation
Par requête selon la résolution- Endpoint
POST /v1/images/tasks- Instantané du catalogue
Qu'est-ce que FLUX 3 Image ?
FLUX 3 Image est le modèle de génération et d'édition d'images publié par Black Forest Labs le 1er octobre 2026, sous le slogan « contrôler chaque pixel ». Sa différenciation : la mise en page par boîtes englobantes — le canevas est abstrait en grille de coordonnées normalisée 0–1000, et vous cernez chaque élément d'une boîte avec sa propre description à la fin du prompt ; le résultat respecte ces contraintes de placement.
L'édition fonctionne aussi par boîte : les modifications d'une image finie se font boîte par boîte sur plusieurs tours, et tout ce qui est hors des boîtes éditées reste identique au pixel près, ce qui limite l'erreur de repeinte au local. Le modèle accepte jusqu'à 10 images de référence (nommées par position dans le prompt) et le grounding — consultation du web pour enrichir le prompt.
Roko expose actuellement cinq paliers (768sq, 1K, 1.5K, 2K, 4K) et 16 rapports d'aspect, facturés par requête selon la résolution choisie (0,041 $ en 768sq jusqu'à 0,607 $ en 4K). Les valeurs coïncidaient avec le tarif BFL lors du contrôle, mais la facturation Roko suit toujours le catalogue actuel du projet. Les appels passent par des tâches asynchrones : soumission, task_id, puis consultation.
Capacités clés
Mise en page par boîtes englobantes
Placez chaque élément sur une grille de coordonnées normalisée et décrivez-le par boîte — la génération devient un problème de mise en page, plus de précision de prompt.
Édition locale par boîte
Modifiez une image finie boîte par boîte sur plusieurs tours ; les zones intactes restent identiques au pixel près, sans dérive globale.
Fusion de 10 références
Combinez jusqu'à 10 images de référence, nommez-les par position dans le prompt, le modèle les place et les rend ensemble.
4K natif et 16 rapports d'aspect
Cinq paliers natifs de 768sq à 4K (~16,8 mégapixels) sur 16 rapports d'aspect — le 4K garde les détails à l'agrandissement.
Prix de l'API FLUX 3 Image
Les tarifs proviennent du catalogue Roko actuel et sont facturés par requête selon la résolution choisie. Ils coïncidaient avec le prix BFL lors du contrôle, mais les prix et promotions en amont ne déterminent pas la facturation Roko ; vérifiez l'estimation et le règlement final Roko.
| Résolution | Prix | Unité |
|---|---|---|
| 768sq | $0.041 | par sortie |
| 1k | $0.048 | par sortie |
| 1.5k | $0.07 | par sortie |
| 2k | $0.1 | par sortie |
| 4k | $0.607 | par sortie |
Exemples de coûts
Palier par défaut — coût standard pour les visuels web et sociaux.
Palier natif maximal pour l'impression et le grand format ; facturé par requête, les requêtes en échec ne sont pas facturées.
Paramètres et périmètre pris en charge
Ces champs proviennent du generation_config public actuel. La syntaxe des boîtes se place à la fin du prompt (coordonnées normalisées 0–1000) ; les capacités hors formulaire suivent la validation de la requête.
| Paramètre | Valeurs | Notes |
|---|---|---|
prompt | textarea | Décrivez l’image à créer ou les modifications à appliquer aux références. · Requis |
images | url / base64 · 1–10 | Les références peuvent utiliser une URL ou Base64 ; la limite applicable figure dans le champ du modèle. · Optionnel |
aspect_ratio | auto / 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 | Choisit le rapport d’aspect de sortie ; auto laisse le modèle décider. · Défaut: auto · Optionnel |
resolution | 768sq / 1k / 1.5k / 2k / 4k | Choisit un palier de résolution configuré pour ce modèle ; la valeur peut influer directement sur le prix. · Défaut: 1k · Optionnel |
safety_tolerance | 0–4 | Roko expose actuellement 0 à 4 : 0 est le plus strict et 4 le plus souple ; défaut 2. · Défaut: 2 · Optionnel |
grounding | boolean | Une fois activé, le modèle peut consulter le web pour enrichir le prompt ; activé par défaut. · Défaut: true · Optionnel |
Appeler FLUX 3 Image avec Roko API
Passez par le flux de tâches asynchrones : soumettez une tâche pour obtenir un task_id, puis consultez le résultat. N'exposez jamais une clé API côté client.
Lancer la génération
curl https://api.rokoapi.com/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
-d '{
"model": "flux-3-image",
"prompt": "Modern city park poster: bounding boxes — fountain center (400,500)-(600,800), skyscrapers background left (0,0)-(350,700), oak trees background right (650,100)-(1000,750)",
"aspect_ratio": "16:9",
"resolution": "1k"
}'Consulter la tâche de récupération
curl https://api.rokoapi.com/v1/tasks/$TASK_ID \
-H "Authorization: Bearer $API_KEY"POST /v1/images/tasks renvoie 202 avec un task_id ; une fois la génération terminée, interrogez GET /v1/tasks/{task_id} pour le résultat ou le motif d'échec. L'Idempotency-Key doit être unique ; les rejeux avec la même clé renvoient la tâche d'origine sans refacturation.
Cas d'usage idéaux
Mises en page et affiches précises
Titres, sujets et arrière-plans obéissent tous aux contraintes de boîtes — compositions publicitaires et affiches.
Poster: product bottle center, headline text box top-left, lifestyle scene bottom — each element in its own bounding box.
Affinage local en plusieurs tours
Éditez boîte par boîte avec un entourage stable au pixel — pour les finals soumis à des allers-retours de validation.
Edit only the bounding box around the logo: replace with the new wordmark, keep everything else pixel-identical.
Synthèse de scènes multi-références
Fusionnez personnes, produits et décors de plusieurs références en une image structurée par boîtes.
Combine the model from image 1, the outfit from image 2, and the studio background from image 3 into one composition.
Impression 4K et grand format
Le 4K natif (~16,8 MP) garde les détails à l'agrandissement — kakemonos et supports imprimés.
Trade-show backdrop at 4K: brand hero center, product lineup along the bottom edge, clean gradient background.
Limites à connaître avant usage
- La facturation est par requête et le palier 4K (0,607 $) coûte bien plus que les paliers inférieurs — utilisez 768sq ou 1K pour les brouillons en volume.
- Les boîtes englobantes utilisent des coordonnées normalisées 0–1000 placées à la fin du prompt ; une syntaxe erronée est traitée comme du texte simple ou rejetée par la validation.
- Roko limite actuellement safety_tolerance à 0–4 (0 le plus strict, 4 le plus souple), avec 2 par défaut ; vérifiez la conformité avant de l'augmenter.
- Une tâche soumise n'est pas une génération réussie — fiez-vous au résultat de la consultation, et revoyez les sorties avant usage.
FLUX 3 Image ou un autre modèle d'image ?
Choisissez FLUX 3 pour la mise en page précise et l'édition par zone ; la famille Seedream convient aux scènes en chinois et aux séries ; GPT Image 2.5 pour les fonds transparents et le contenu courant. Arbitrez entre granularité de contrôle, résolution et prix.
Tous les modèles →FAQ FLUX 3 Image
Quel ID de modèle utiliser pour FLUX 3 Image ?
Utilisez l'ID public de Roko API : flux-3-image, tel quel dans le champ model.
Combien coûte l'API FLUX 3 Image ?
Facturation par requête selon la résolution : 0,041 $ en 768sq, 0,048 $ en 1K, 0,07 $ en 1.5K, 0,10 $ en 2K, 0,607 $ en 4K. Les valeurs coïncidaient avec le tarif BFL lors du contrôle, mais la facturation Roko suit l'estimation du projet et le règlement final à la soumission.
Comment fonctionnent les mises en page par boîtes ?
Le schéma officiel normalise le canevas sur 0–1000 et place une boîte plus description par élément à la fin du prompt, ex. « fountain (400,500)-(600,800) ». Le résultat respecte ces contraintes de placement.
Que signifie l'édition par boîte ?
Vous éditez une image finie boîte par boîte : seule la zone intérieure à une boîte est repeinte, tout le reste reste identique au pixel près, et vous pouvez itérer sur plusieurs tours sans dérive globale.
Quelles résolutions et rapports d'aspect sont pris en charge ?
Roko expose actuellement 768sq, 1K, 1.5K, 2K et 4K plus 16 rapports d'aspect (auto par défaut). Le 4K fait environ 16,8 mégapixels — un rendu natif, pas un agrandissement.
Quel endpoint utiliser pour FLUX 3 Image ?
Soumettez des tâches asynchrones via POST /v1/images/tasks pour obtenir un task_id, puis interrogez GET /v1/tasks/{task_id} pour le résultat ou le motif d'échec.
À quoi sert le paramètre grounding ?
Avec grounding activé, le modèle peut consulter le web pour enrichir le prompt (faits en temps réel, descriptions de supports de marque). Il est activé par défaut ; désactivez-le explicitement si inutile.
Peut-on utiliser les poids ouverts ?
Au dernier contrôle (06-10-2026), BFL annonce des poids ouverts « dans les semaines à venir » ; les poids commerciaux exigent une licence directe. Sur Roko, les requêtes passent par le canal API officiel de BFL.