Ce guide n'est disponible qu'en anglais pour le moment. →
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
seed | Non | Le même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647 |
prompt | Oui | Describe the subject, setting, light and style in plain sentences. |
resolution | Non | Taille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. 1k · 2k · Par défaut: 1k |
aspect_ratio | Non | La forme du cadre : large, carrée ou verticale. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Par défaut: 1:1 |
Tarifs
Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,01 $). Le montant est réservé à l'acceptation de la tâche, puis réglé au coût réel à la fin ; les tâches en échec sont remboursées.
| Option | Crédits par image | ≈ USD |
|---|---|---|
| Standard | 1,74 | 0,017 $US |
Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 2 crédits par image (0,02 $US).
Pour obtenir un montant exact avant de lancer, envoyez le même corps à POST /jobs/quote.
Démarrage rapide de l'API
Appeler l’API FLUX.2 Dev en trois étapes
- Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow- et utilisent les mêmes crédits que le site.
- Envoyer la requête. Envoyez POST /jobs/createTask avec model black-forest-labs/flux-2-dev/text-to-image et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
- Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-2-dev/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"resolution": "1k"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.
Questions sur l’API FLUX.2 Dev
Combien coûte l’API FLUX.2 Dev ?
FLUX.2 Dev coûte à partir de 2 crédits (0,02 $US) par image avec Créer une image, sa tâche la moins chère. Les crédits sont les mêmes que sur le site (1 crédit = 0,01 $), les nouveaux comptes reçoivent 30 crédits offerts et les tâches échouées sont remboursées.
Quel est le nom de modèle de FLUX.2 Dev dans l’API ?
Indiquez black-forest-labs/flux-2-dev/text-to-image pour Créer une image; black-forest-labs/flux-2-dev/edit pour Modifier une image dans le champ model de POST /jobs/createTask.
Peut-il écrire du texte dans l’image ?
Oui, les textes courts fonctionnent bien : lors de nos tests, les enseignes entre guillemets sont ressorties orthographiées comme écrites. Mettez les mots exacts entre guillemets et indiquez où ils vont. Les longs paragraphes peuvent encore contenir des erreurs.
Les couleurs hexadécimales fonctionnent-elles ?
Oui, comme indice fort. Un code tel que #FF4F8B placé près de l’enseigne au néon a teinté la pièce en magenta. Ce n’est pas une correspondance de couleur exacte.
Combien d’images de référence puis-je utiliser ?
Une à trois en mode Retouche, dans l’ordre où votre prompt les mentionne. Écrivez « la femme de l’image 1 » et « l’homme de l’image 2 » quand vous réunissez des personnes.
Quelles sont les limites de l’API FLUX.2 Dev ?
Résolutions: 1K · 2K; Formats d’image: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Longueur du prompt (caractères): 5,000. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer FLUX.2 Dev sans écrire de code ?
Oui. Le Playground lance FLUX.2 Dev avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.
Tous les modèles FLUX
FLUX.2 Pro reste plus constant sur le texte et les visages ; Dev est le modèle ouvert de la famille.
- API FLUX.2 MaxLe FLUX haut de gamme : lumière photoréaliste et couleurs de marque exactesÀ partir de 11 crédits par image
- API FLUX 3Vidéo au son synchronisé, avec un mode brouillon rapideÀ partir de 45 crédits pour un clip de 5 secondes
- API FLUX.2 Klein 9B LoRAFLUX.2 Klein 9B rapide, jusqu’à trois de tes LoRAÀ partir de 3 crédits par image
- API FLUX.2 Klein Base 9B LoRAKlein 9B non distillé pour des rendus variés avec tes LoRAÀ partir de 4 crédits par image
- API FLUX.2 Klein 4B LoRAFLUX.2 Klein 4B petit et rapide, avec tes propres LoRAÀ partir de 3 crédits par image
- API FLUX.2 Klein Base 4B LoRAKlein 4B non distillé qui charge tes propres LoRAÀ partir de 3 crédits par image
- API FLUX.2 Klein 9BRetouches FLUX rapides qui préservent visages et posesÀ partir de 2 crédits par image
- API FLUX.2 Klein 4BLe FLUX le plus léger et le plus rapide, pour les brouillonsÀ partir de 2 crédits par image
- API FLUX.2 Dev LoRAImages et retouches FLUX.2 Dev avec tes propres LoRAÀ partir de 4 crédits par image
- API FLUX.2 ProImages photoréalistes, texte lisible et couleurs au code hexaÀ partir de 5 crédits par image
- API FLUX.2 FlexÉcrit titres et étiquettes exactement comme tu les tapesÀ partir de 9 crédits par image
- API FLUX.2 DevFLUX à poids ouverts, capable de réunir plusieurs personnes dans une scèneÀ partir de 2 crédits par image
- API FLUX.1 Krea Dev LoRAFLUX.1 Krea au rendu photo, avec tes propres LoRAÀ partir de 4 crédits par image
- API FLUX.1 Dev ControlNet LoRAContrôle par pose, profondeur ou contours sur FLUX.1, avec tes LoRAÀ partir de 6 crédits par image
- API FLUX.1 Fill Dev LoRAInpainting par masque sur FLUX.1 Fill avec tes propres LoRAÀ partir de 7 crédits par image
- API FLUX.1 Dev LoRALe classique FLUX.1 Dev avec jusqu’à trois de tes LoRAÀ partir de 3 crédits par image
- API FLUX.1 Schnell LoRAFLUX.1 Schnell rapide qui charge tes propres LoRAÀ partir de 1 crédit par image

