Obtenir une clé API

par Black Forest Labs

Contrôle par pose, profondeur ou contours sur FLUX.1, avec tes LoRA

black-forest-labs/flux-1-dev-controlnet-lora/text-to-imageÀ partir de 6 créditspar image · 0,06 $US
  • Jusqu’à 1.5K
  • Jusqu’à 4 par génération
  • Charge vos propres LoRA
  • Créer une image
Atelier night grayscaleVoir les exemples

À propos de FLUX.1 Dev ControlNet LoRA

FLUX.1 Dev ControlNet LoRA génère des images avec FLUX.1 [dev] de Black Forest Labs, guidé par ControlNet Union Pro 2.0 de Shakker Labs, avec jusqu’à trois fichiers LoRA entraînés pour FLUX.1 dev. Une image de contrôle (squelette de pose, carte de profondeur, contours canny ou soft edge, ou photo en niveaux de gris) fixe la composition ; le prompt décide du reste, et rien n’est filtré.

Appelez-le avec le nom de modèle black-forest-labs/flux-1-dev-controlnet-lora/text-to-image sur POST /jobs/createTask, à partir de 6 crédits par image (0,06 $US). Les nouveaux comptes reçoivent 30 crédits gratuits pour l’essayer d’abord dans le Playground.

Ce guide n'est disponible qu'en anglais pour le moment. →

Paramètres de requête

ParamètreRequisDescription
control_guidance_endNonFraction of the denoising steps at which the control image stops applying, from 0 to 1; not before the start. ≥ 0 · ≤ 1 · Par défaut: 0.8
control_guidance_startNonFraction of the denoising steps at which the control image starts to apply, from 0 to 1. ≥ 0 · ≤ 1 · Par défaut: 0
control_image_urlOuiControl image: a pose skeleton, depth map, canny or soft-edge line map, or a grayscale or plain photo. The result keeps its aspect ratio.
control_strengthNonHow strongly the result follows the control image, from 0 to 1. ≥ 0 · ≤ 1 · Par défaut: 0.7
guidance_scaleNonÀ quel point le modèle suit le prompt à la lettre. ≥ 0 · ≤ 20 · Par défaut: 3.5
lorasNonChargez vos propres fichiers LoRA pour fixer un style ou un personnage. Par défaut: []
num_outputsNonCombien de résultats en une fois. ≥ 1 · ≤ 4 · Par défaut: 1
output_formatNonLe type de fichier du résultat. jpeg · png · webp · Par défaut: jpeg
promptOuiDescribe the picture you want: subject, clothing, setting and light. The control image only sets the layout.
resolutionNonTaille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. 1k · 1.5k · Par défaut: 1k
seedNonLe même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647
stepsNonPlus d’étapes ajoutent du détail mais prennent plus de temps. ≥ 1 · ≤ 50 · Par défaut: 28

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.

OptionCrédits par image≈ USD
Standard5,40,054 $US

Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 6 crédits par image (0,06 $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.1 Dev ControlNet LoRA en trois étapes

  1. 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.
  2. Envoyer la requête. Envoyez POST /jobs/createTask avec model black-forest-labs/flux-1-dev-controlnet-lora/text-to-image et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
  3. 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-1-dev-controlnet-lora/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "control_image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1k",
    "num_outputs": 1,
    "output_format": "jpeg"
  }
}'

# 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.1 Dev ControlNet LoRA

Combien coûte l’API FLUX.1 Dev ControlNet LoRA ?

FLUX.1 Dev ControlNet LoRA coûte 6 crédits (0,06 $US) par image. 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.1 Dev ControlNet LoRA dans l’API ?

Indiquez black-forest-labs/flux-1-dev-controlnet-lora/text-to-image pour Créer une image dans le champ model de POST /jobs/createTask.

Qu’est-ce qu’une image de contrôle ?

Une carte de la structure voulue : un squelette de pose en couleurs, une carte de profondeur en niveaux de gris, des contours canny ou soft edge blancs sur fond noir, ou une photo en niveaux de gris. Le modèle en reprend la composition et la pose, et tire tout le reste du prompt.

Détecte-t-il la pose ou la profondeur à ma place ?

Non. Envoyez la carte elle-même. Une simple photo est acceptée aussi, mais elle contraint l’image comme une carte en niveaux de gris : les contours et la forme des vêtements se retrouvent dans le résultat.

Quels LoRA fonctionnent ici ?

Les LoRA entraînés pour FLUX.1 dev, transmis sous forme de lien de téléchargement direct vers le fichier .safetensors. Lors de nos tests, un LoRA SDXL a fait échouer la requête : vérifiez donc le modèle de base sur la page du LoRA avant de le charger.

Puis-je utiliser les images à des fins commerciales ?

La licence FLUX.1 [dev] de Black Forest Labs vous permet d’utiliser les images générées à des fins personnelles, scientifiques et commerciales. La licence de chaque LoRA que vous chargez est fixée par son auteur : vérifiez sa fiche de modèle.

Quelles sont les limites de l’API FLUX.1 Dev ControlNet LoRA ?

Résolutions: 1K · 1.5K; Résultats par appel: 1–4; Longueur du prompt (caractères): 5,000; Taille maximale d’envoi: 10 MB. Les requêtes hors de ces limites sont refusées avant tout débit.

Puis-je essayer FLUX.1 Dev ControlNet LoRA sans écrire de code ?

Oui. Le Playground lance FLUX.1 Dev ControlNet LoRA avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.

Tous les modèles FLUX

FLUX.1 Dev LoRA n'a pas d'image de contrôle et convient à la composition libre.

En savoir plus sur FLUX.1 Dev ControlNet LoRA