API FLUX 3 Image
Roko propose FLUX 3 Klein via Kie AI sous flux-3-image. Sans image de référence, la requête génère une image ; avec des références, elle sélectionne automatiquement la retouche. Résolutions : 1K, 2K et 4K, pour 1 à 4 sorties.
- ID public du modèle
flux-3-image- Paliers de sortie
1K / 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 ?
L’ID public flux-3-image utilise actuellement FLUX 3 Klein via Kie AI. Il ne donne pas accès à toutes les fonctions de l’API FLUX 3 Image complète de BFL.
Conservez le même ID : sans référence, la requête génère une image ; avec 1 à 10 URL publiques, elle sélectionne automatiquement la retouche.
Choisissez 1K, 2K ou 4K et 1 à 4 sorties. Soumettez une tâche asynchrone puis consultez son résultat. La facturation dépend de la résolution et du nombre de sorties réussies.
Capacités clés
Génération depuis du texte
Décrivez le sujet, le fond et le style sans sélectionner un autre modèle en amont.
Retouche avec références
Fournissez 1 à 10 références et indiquez les changements souhaités. Vérifiez le résultat.
Sorties multiples
n va de 1 à 4. Le règlement tient compte des sorties réussies.
Trois résolutions
Choisissez 1K, 2K ou 4K avec un format d’image pris en charge.
Prix de l'API FLUX 3 Image
Les tarifs proviennent du catalogue Roko actuel et sont facturés par image générée selon la résolution choisie. Ils coïncidaient avec le prix standard Kie AI 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é |
|---|---|---|
| 1k | $0.01 | par sortie |
| 2k | $0.016 | par sortie |
| 4k | $0.036 | par sortie |
Exemples de coûts
Palier par défaut — coût standard pour les visuels web et sociaux.
Le règlement utilise les sorties réussies. Calcul fondé sur l’instantané tarifaire actuel.
Paramètres et périmètre pris en charge
Ces champs suivent la configuration Kie actuelle. Les références exigent des URL HTTP / HTTPS publiques. Les réglages dédiés de placement par cadres, grounding et safety_tolerance ne sont pas exposés.
| Paramètre | Valeurs | Notes |
|---|---|---|
prompt | textarea | Décrivez l’image à créer ou les modifications à appliquer aux références. · Requis |
images | url · 1–10 | Utilisez jusqu’à 10 URL HTTP / HTTPS publiques. Base64 et les URL blob: du navigateur ne sont pas acceptés. · Optionnel |
aspect_ratio | auto / 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9 / 9:21 | En retouche, auto suit l’image de référence. En génération depuis du texte, auto ou un ratio absent donne 1:1. · Défaut: auto · Optionnel |
resolution | 1k / 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 |
n | 1–4 | Nombre d’images générées par requête ; plus de sorties, plus de frais. · Défaut: 1 · Optionnel |
output_format | png / jpeg / webp | Format de fichier des images générées : png ou jpeg. · Défaut: png · Optionnel |
enhance_prompt | boolean | Optionnel |
seed | integer | 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": "A ceramic mug on a white studio background, soft side lighting.",
"aspect_ratio": "16:9",
"resolution": "2k"
}'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
Ébauches de scènes produit
Décrivez le produit, la lumière et le fond ; vérifiez d’abord la composition en 1K.
A ceramic mug on a white studio background, soft side lighting.
Changement de fond ou de couleur
Ajoutez des références et précisez les modifications, sans supposer que tous les autres pixels resteront identiques.
Change the mug to blue while keeping its shape and the white background.
Composition avec plusieurs références
Indiquez le sujet, le style ou le décor fourni par chaque image.
Use the product from image 1 and the background from image 2.
Exploration de variantes
Demandez jusqu’à quatre sorties avec n, puis examinez et choisissez une version.
Create alternative studio compositions of a ceramic mug.
Limites à connaître avant usage
- Utilisez 1 à 10 URL HTTP / HTTPS publiques ; Base64, les Data URL et les URL blob: ne sont pas acceptés.
- Neuf ratios fixes sont disponibles. La retouche accepte auto ; en génération depuis du texte, auto ou un ratio absent donne 1:1.
- Cette intégration Klein ne garantit pas la conservation exacte des pixels hors retouche et n’expose pas les commandes dédiées de mise en page ou de recherche web de l’API complète.
- L’envoi confirme seulement la réception. Consultez la tâche jusqu’à son état final et vérifiez l’image avant usage.
FLUX 3 Image ou un autre modèle d'image ?
Choisissez selon la tâche, les limites des références, la résolution et les tarifs actuels. Cette page ne présente pas de comparaison contrôlée de qualité ou de vitesse.
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 image générée selon la résolution : 0,008 $ en 1K, 0,0125 $ en 2K, 0,0325 $ en 4K. Les valeurs coïncidaient avec le tarif standard Kie AI lors du contrôle, mais la facturation Roko suit l'estimation du projet et le règlement final à la soumission.
Faut-il changer d’ID pour retoucher ?
Non. Gardez flux-3-image : sans référence pour générer, avec références pour sélectionner automatiquement la retouche.
Comment fournir les références ?
Envoyez 1 à 10 URL d’images HTTP / HTTPS publiques dans image_urls ou images. image et input_reference sont aussi acceptés.
Quelles résolutions et quels ratios sont disponibles ?
1K, 2K et 4K ; ratios fixes : 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 et 9:21. auto est disponible en retouche et vaut 1:1 en génération depuis du texte.
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.
S’agit-il de l’API BFL complète ?
Cette route utilise FLUX 3 Klein via Kie AI. Elle n’expose pas les réglages dédiés de placement par cadres ou de recherche web ; les capacités de l’API complète ne doivent pas être supposées.
Combien d’images par tâche ?
n accepte 1 à 4, avec 1 par défaut. Le coût dépend des sorties réussies et de la résolution choisie.