Guide de l'API FLUX 3 Image Klein : tarifs à cinq paliers de résolution, paramètres et exemples d'appel

Qu'est-ce que FLUX 3 Image Klein

FLUX 3 Image Klein est le modèle d'image léger de la série FLUX 3 de Black Forest Labs. Sur HiAPI, il n'existe qu'un seul ID de modèle : flux-3-image-klein, utilisé à la fois pour la génération d'images à partir de texte et pour l'édition à partir d'images de référence. Indiquez uniquement un prompt pour faire de la génération texte-image ; ajoutez image_urls pour modifier une scène selon des images de référence ou fusionner les styles de plusieurs images.

Ses atouts sont son faible coût et la diversité de ses paliers : cinq résolutions de 768 à 4K, idéal pour la génération par lots et pour un flux de travail consistant à tester en petit puis à finaliser en grand.

Tarifs : selon le palier de résolution, facturés à l'image

• 768 : 0,0092 $ / image
• 1K (par défaut) : 0,0103 $ / image
• 1,5K : 0,0126 $ / image
• 2K : 0,016 $ / image
• 4K : 0,0412 $ / image

Les images de référence ne sont pas facturées en supplément : 1 ou 10 images de référence coûtent le même prix. Réduire steps ne réduit pas le prix ; le tarif dépend uniquement de resolution. Les tâches échouées sont entièrement remboursées.

Par exemple : tester 50 ébauches de style en 768 coûte 0,46 $ ; en retenir 5 et les finaliser en 4K coûte 0,206 $.

Paramètres

Hormis model et prompt, tous les paramètres sont facultatifs :

• prompt : obligatoire, 1 à 5000 caractères.
• resolution : 768, 1K, 1.5K, 2K, 4K, par défaut 1K.
• aspect_ratio : 16 valeurs possibles, dont 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 et auto (par défaut).
• image_urls : 1 à 10 images de référence accessibles publiquement, à omettre pour une génération purement texte-image.
• steps : 1 à 16, par défaut 16. Moins d'étapes génère plus vite, avec potentiellement moins de détails.
• seed : 0 à 4294967295. Avec une graine fixée, les mêmes paramètres reproduisent autant que possible des résultats similaires ; si omis, la graine est aléatoire.
• safety_tolerance : 0 à 4, par défaut 2. Plus le chiffre est élevé, plus la modération est permissive.
• output_format : jpeg (par défaut) ou png.

Exemples de requête

Les tâches d'image sont asynchrones : créez d'abord la tâche, puis interrogez le résultat. Placez model au niveau supérieur et les autres paramètres dans input.

Génération texte-image, 2K, format portrait 4:5, graine fixée :

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-image-klein",
    "input": {
      "prompt": "Une tasse à café en céramique posée sur une table en bois éclairée par la lumière du matin, profondeur de champ courte, tons chauds, photographie de produit",
      "resolution": "2K",
      "aspect_ratio": "4:5",
      "seed": 42
    }
  }'

Cette image coûte 0,016 $.

Édition à partir d'images de référence, fusion des styles de deux images :

{
  "model": "flux-3-image-klein",
  "input": {
    "prompt": "Conserver la structure architecturale de la première image et la redessiner avec les coups de pinceau aquarelle et la palette de la seconde image",
    "image_urls": [
      "https://example.com/building.jpg",
      "https://example.com/watercolor.jpg"
    ],
    "resolution": "1.5K",
    "output_format": "png"
  }
}

Une fois la tâche créée, interrogez GET https://api.hiapi.ai/v1/tasks/{taskId} avec l'ID de tâche renvoyé ; en cas de succès, récupérez l'adresse de l'image dans la sortie.

Conseils d'utilisation

• D'abord petit, puis grand : testez votre prompt en 768 ou 1K avec un seed fixe, puis, une fois satisfait, changez seulement resolution en 2K ou 4K et relancez une génération.
• Variantes en lot : avec le même prompt et des seed différents, vous obtenez un ensemble de candidats aux compositions variées mais au style cohérent.
• Pour l'édition, précisez clairement ce qu'il faut conserver : avec des images de référence, indiquez dans le prompt ce qui doit être conservé et ce qui doit être modifié ; c'est plus stable que de décrire uniquement l'image cible.

Limites actuelles

• Chaque appel renvoie une seule image.
• Maximum 10 images de référence, qui doivent être des adresses http(s) accessibles publiquement.
• Aucune option de fond transparent ; png n'est qu'un format sans perte alternatif.