Black Forest Labs

FLUX 3 Image Klein

flux-3-image-klein

Essayer flux-3-image-klein

Entrée

Sortie

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

flux-3-image-klein per image

Spécifications	Prix unitaire
768	$0.0092
1K	$0.0103
1.5K	$0.0126
2K	$0.016
4K	$0.0412

Présentation en préparation

Un guide détaillé de ce modèle est en préparation. Les tarifs, paramètres et la documentation API ci-dessous sont déjà disponibles.

Nouveautés

Voir le journal des modifications →

Nouveau modèle Nouveau modèle disponible : FLUX 3 Image Klein Nov 11, 2026

Questions fréquentes

Voir toutes les questions →

Pourquoi un prompt court produit-il des images si vagues ?

Un prompt court contient trop peu d'informations : le modèle ne peut que compléter selon les interprétations courantes, ce qui donne des résultats vagues. Rédiger le prompt sous forme de description complète est bien plus stable : ① sujet et détails d'apparence ② scène et environnement ③ lumière et tonalité ④ composition et point de vue ⑤ style et exigences de qualité d'image. Le prompt est limité à 5000 caractères, largement suffisant pour tout détailler point par point.
Comment basculer entre la génération texte-vers-image et l'édition d'image ?

Le même modèle offre deux usages, la seule différence étant la présence ou non d'une image de référence. Omettre image_urls correspond à la génération texte-vers-image, qui génère uniquement à partir du prompt ; fournir image_urls bascule vers une édition par instruction, et le prompt doit alors préciser clairement quelles parties de l'image de référence doivent être modifiées et lesquelles doivent être conservées. Lors de l'édition, il est recommandé d'énumérer une par une les zones à modifier et l'effet souhaité, plutôt que d'écrire une seule phrase sur le style global.
Combien d'images de référence puis-je utiliser au maximum ?

image_urls accepte au maximum 10 images et au minimum 1 ; dès qu'une image de référence est fournie, le mode édition ou composition multi-références est activé. Il faut préciser le rôle de chaque image dans le prompt, par exemple la première est le personnage, la deuxième le produit, la troisième le style d'arrière-plan. Cette limite convient aux scénarios de composition nécessitant une cohérence des personnages ou des produits entre les images.
Comment contrôler la mise en page ?

Utilisez les balises du prompt accompagnées d'un JSON bbox pour spécifier la position des éléments. Dans le prompt, écrivez des espaces réservés de la forme <balise> et joignez le JSON de boîte englobante correspondant, en indiquant dans quelle zone placer chaque élément, puis écrivez la description concrète dans le contenu associé à la balise. Cela convient aux images comme les affiches ou les bannières qui nécessitent des positions de mise en page fixes.

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.

Idempotency-KeystringOptionnel

Clé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.

Clé d'idempotence

En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.

Corps

modelstringRequis

Valeur fixe actuelle : flux-3-image-klein

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour flux-3-image-klein et la route default — voir le tableau des paramètres ci-dessous.

seedintegerOptionnelmin 0max 4294967295

随机种子，用于尽量复现相同参数下的结果。省略时随机。

stepsintegerOptionnelDéfaut: 16min 1max 16

扩散步数，1–16；数值越低生成越快，细节可能减少，不影响价格。

promptstringRequisminLength 1maxLength 5000

描述想生成的画面，或说明参考图中需要修改与保留的内容。可用 <标签> 配合 bbox JSON 指定布局与局部编辑区域。

image_urlsarrayOptionnelminItems 1maxItems 10

提供参考图片，并在提示词中说明每张图片的主体、风格或构图角色。省略即为文生图。

Array [ string ]

resolutionstringOptionnelDéfaut: "1K"

选择输出像素档位；具体宽高随画幅变化。

Options：7681K1.5K2K4K

aspect_ratiostringOptionnelDéfaut: "auto"

选择横图、竖图或方图；自动模式根据提示词与参考图确定画幅。

Options：21:92:116:93:27:54:35:41:1

Tout afficher (8)Afficher moins

4:53:45:72:39:161:29:21auto

output_formatstringOptionnelDéfaut: "jpeg"

输出图片格式。

Options：jpegpng

safety_toleranceintegerOptionnelDéfaut: 2min 0max 4

内容安全宽容度，0 最严格。

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.

urlstringRequis

Obligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.

whenstringOptionnelDéfaut: "final"

Seul final est pris en charge pour l'instant — notifié sur success et fail.

Options：final

storagestringOptionnelDéfaut: "temp"

Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.

Options：temppersistent

Exemples de requête

# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
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": {
    "steps": 16,
    "prompt": "…",
    "resolution": "1K",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "safety_tolerance": 2
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "flux-3-image-klein",
    input: {
      "steps": 16,
      "prompt": "…",
      "resolution": "1K",
      "aspect_ratio": "auto",
      "output_format": "jpeg",
      "safety_tolerance": 2
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "flux-3-image-klein",
        "input": {
          "steps": 16,
          "prompt": "…",
          "resolution": "1K",
          "aspect_ratio": "auto",
          "output_format": "jpeg",
          "safety_tolerance": 2
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtenir le détail de la tâche

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

queued En file, pas encore démarrée. handling En cours de traitement. archiving Traitement terminé, préparation des artefacts. success Terminal : terminé, artefacts disponibles (output renvoyé). fail Terminal : échec (error renvoyé). Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes Unix de l'état terminal ; 0 tant que non terminal.

outputarrayOptionnel

Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).

Array [ object ]

Éléments du tableau

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description de l'erreur.

Exemples de réponse

Succès

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En cours (non terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Échec

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}