Modeles officiels BFL FLUX

Cette page decrit l integration des modeles officiels BFL FLUX dans Magick API. Les clients appellent les points d entree image compatibles OpenAI. Le gateway convertit la requete vers l API asynchrone BFL, interroge le resultat, puis renvoie un ImageResponse synchrone.

Modeles pris en charge

Authentification et reponse

Utilisez un token Magick API pour appeler le gateway :

Authorization: Bearer YOUR_API_KEY

La cle officielle BFL est configuree dans le canal BFL du tableau de bord. Ne transmettez pas la cle amont BFL directement depuis les clients.

Les reponses reussies utilisent le format image compatible OpenAI :

{
  "created": 1712345678,
  "data": [
    {
      "url": "https://signed-result-url.example/image.png"
    }
  ],
  "metadata": {
    "id": "bfl-task-id",
    "status": "Ready",
    "cost": 3,
    "input_mp": 0,
    "output_mp": 1
  }
}

Definissez "response_format": "b64_json" si vous voulez que le gateway telecharge l image BFL et renvoie data[0].b64_json.

Champs compatibles communs

Parametres FLUX.2

S applique a flux2_text_to_image, flux2_image_editing et flux-2-pro-preview.

curl --request POST \
  --url https://api.magickapi.com/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux2_text_to_image",
    "prompt": "A precise product photo of a matte black espresso machine on a white counter",
    "size": "1024x1024",
    "output_format": "png",
    "safety_tolerance": 2,
    "seed": 42,
    "response_format": "url"
  }'

curl --request POST \
  --url https://api.magickapi.com/v1/images/edits \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux2_image_editing",
    "prompt": "Use the chair from image 2 in the room from image 1, keep natural shadows",
    "images": [
      "https://example.com/room.png",
      "https://example.com/chair.png"
    ],
    "size": "1024x1024",
    "output_format": "jpeg",
    "safety_tolerance": 2
  }'

Parametres FLUX.1.1 Pro

S applique a flux-pro-1.1.

Parametres FLUX.1 Fill

S applique a flux_1_fill. Pour les appels Magick API FLUX.1 Fill, les clients aval appellent toujours l endpoint compatible OpenAI POST /v1/images/edits. N appelez pas directement le chemin officiel BFL /v1/flux-pro-1.0-fill ; le gateway convertit en interne model: "flux_1_fill" vers le modele BFL amont. Fournissez image, mask et prompt ensemble. image et mask doivent etre des images Base64. Le noir est conserve et le blanc est repeint.

:::warning[Debogage]

• image et mask peuvent inclure le prefixe data:image/...;base64, ou etre du Base64 brut. N envoyez pas d URL d image, sinon le gateway renverra “requires base64 image data”.
• mask doit avoir exactement les memes dimensions que image. Une erreur frontend courante consiste a exporter le mask a la taille de preview, par exemple image=1152x896 mais mask=720x560 ; BFL renvoie alors 422 et le gateway peut seulement exposer openai_error / bad_response_status_code.
• Envoyez explicitement response_format: "url" et output_format: "png" pour une reponse image compatible OpenAI previsible. :::

Parametres FLUX Erase

S applique a flux-erase. Le chemin amont officiel est flux-tools/erase-v1.

Facturation

BFL peut renvoyer cost, input_mp et output_mp dans la reponse de soumission. Magick API utilise cost pour le reglement final lorsqu il est present. Si BFL ne renvoie pas de cout dynamique, le prix fixe du modele configure dans le backend est utilise. Un credit BFL vaut $0.01.