Ugrás a tartalomhoz

FLUX.1 [dev] with Controlnets and Loras · Differential Diffusion

Integráció

Modellazonosító flux-general/differential-diffusion
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/flux-general/differential-diffusion?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "change_map_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ez a kérés: ≈0,138 $ 138 API-jóváírás Futtatás ezen az oldalon

API-kulcs beszerzése
Black Forest Labs Képszerkesztés Referencia-bemenetek #lora#controlnet#ip-adapter

FLUX.1 [dev] képszerkesztés változástérképpel, amely az egyes régiók módosításának mértékét szabályozza

Black Forest Labs · Kép

Az első eredményed itt jelenik meg

Állíts össze egy kérést alább, majd futtasd az API-kulcsoddal. A kimeneteket a tárhelyünkre másoljuk, és örökre vagy 7 nap ideig ingyenesen őrizzük meg.

Kérés összeállítása

A vezérlők a modell sémájából jönnek létre. A kód és az ár a módosításokkal együtt frissül.

•kötelező

A képgenerálást vezérlő prompt.

•kötelező image_url
Húzz egy fájlt ide, vagy

A kezdeti képet biztosító kép URL-je.

•kötelező
Húzz egy fájlt ide, vagy

A változástérképre mutató URL.

image_size

A generált kép méretei.

num_images alapértelmezett: 1

A generálandó képek számának beállítása; streamelt kimenet esetén ez az érték mindig 1.

Speciális negative_prompt · reference_image_url · output_format · scheduler · sigma_schedule · num_inference_steps · guidance_scale · real_cfg_scale · reference_strength · reference_start · reference_end · base_shift · max_shift · nag_scale · nag_tau · nag_alpha · nag_end · strength · seed · use_real_cfg · use_cfg_zero · enable_safety_checker · use_beta_schedule · loras · control_loras · controlnets · controlnet_unions · ip_adapters · easycontrols · fill_image
alapértelmezett:

Alapértelmezés szerint NAG-gal feldolgozott negatív prompt, amely visszaszorítja a generált képekben megadott nem kívánt jellemzőket.

Húzz egy fájlt ide, vagy

A Reference-Only guidance számára használt kép URL-je.

output_format alapértelmezett: png

A létrejövő kép fájlformátuma.

scheduler alapértelmezett: euler

A zajcsökkentés során használt ütemező.

A zajcsökkentés során használt szigmaütemezés.

alapértelmezett: 28

A végrehajtandó inferencialépések száma.

alapértelmezett: 3.5

A kép kiválasztásának promptkövetési erőssége, CFG-ként (Classifier Free Guidance) megadva.

alapértelmezett: 3.5

A kép kiválasztásának promptkövetési erőssége, CFG-ként (Classifier Free Guidance) megadva.

alapértelmezett: 0.65

A referencia-kép hatása reference_only generálás során; megadott referencia-kép nélkül ez az erősségbeállítás nincs hatással az eredményre.

alapértelmezett: 0

A referencia-vezérlés kezdőpontja az összes időlépés százalékában.

alapértelmezett: 1

A referencia-vezérlés végpontja az összes időlépés százalékában.

alapértelmezett: 0.5

Az ütemezett időlépésekre alkalmazott alapeltolás.

alapértelmezett: 1.15

Az ütemezett időlépésekre alkalmazott maximális eltolás.

alapértelmezett: 3

A negatív prompt elkerülését a NAG skálája szabályozza: növelése kevésbé teszi a generált képet a negatív leíráshoz hasonlóvá.

alapértelmezett: 2.5

NAG tau-beállítás a rejtett állapot normalizálásához; ajánlott változatlanul hagyni. Növelése gyengíti a normalizálást, és az eredeti képtől való váratlan eltérések kockázatával jár.

alapértelmezett: 0.25

A NAG alpha azt határozza meg, hogy a pozitív prompt mennyire irányítja át a pozitív és negatív promptot egyesítő normalizált vezérlést. Ez a végső súlyozás alacsonyabb értékeknél nagyobb hatást biztosít a pozitív promptnak, magasabb értékeknél pedig csökkenti az átirányítást.

alapértelmezett: 0.25

A NAG levágási pontja a generálási lépések arányaként megadva. A FLUX eredeti figyelemfeldolgozói azután veszik át a vezérlést, hogy a NAG lefutott ezen kezdeti arányon.

alapértelmezett: 0.85

Differenciális diffúziós erősség: 0.0 esetén az eredeti megőrzésétől 1.0 esetén teljes újragenerálásig terjed.

Reprodukálható képekhez használt seed: azonos prompt és seed azonos modellszverzió mellett azonos képet eredményez.

alapértelmezett: []

Azok a LoRA-k, amelyek együttes hatása létrehozza a generált képet; a megadható LoRA-k száma nincs korlátozva.

alapértelmezett: []

A vezérlőképek LoRA-i egyetlen konfigurációba egyesítve a végső kép generálásához; a megadott szám korlátlan.

alapértelmezett: []

ControlNet-konfiguráció képgeneráláshoz, jelenleg egyetlen ControlNetre korlátozva.

alapértelmezett: []

ControlNet union-konfiguráció képgeneráláshoz, az aktuális egyetlen-ControlNet korlátozás mellett.

alapértelmezett: []

A képgenerálás során alkalmazott IP-Adapter.

alapértelmezett: []

A képgenerálás során alkalmazott EasyControl-bemenetek.

A generálást vezérlő bemeneti kép, amely maszkolt területekhez is biztosíthat tartalmat.

POST /run/flux-general/differential-diffusion?wait=20 ár → 0,138 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/flux-general/differential-diffusion?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "change_map_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Kérés futtatása

A kulcsod ebben a böngészőben marad: csak a Doitong API-nak küldjük el, és csak akkor mentjük a localStorage-ba, ha bejelölöd az Emlékezz rám lehetőséget. API-kulcs igénylése

A(z) FLUX.1 [dev] with Controlnets and Loras · Differential Diffusion bemutatása

Régiónként alakítja át a forrásképet, egy változástérképpel szabályozva az egyes területek módosításának mértékét. Kötelező a `prompt`, az `image_url` és a `change_map_image_url`. LoRA-k, ControlNetek, IP-Adapterek és referenciakép is elfogadható. A `num_inference_steps` 1–50, a `num_images` legfeljebb 10 lehet; a kimenet png vagy jpeg.

Paraméterek

Küldd el a kanonikus nevet vagy a natív nevet, de ne mindkettőt. Kanonikus nevek

NévTípus AlapértelmezettEngedélyezett Leírás
promptkötelező
Típusstring
A képgenerálást vezérlő prompt.
image_sizenem kötelező
Típusobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
A generált kép méretei.
num_inference_stepsnem kötelező
Típusinteger
Alapértelmezett28
1 – 50
A végrehajtandó inferencialépések száma.
seednem kötelező
Típusinteger | null
Reprodukálható képekhez használt seed: azonos prompt és seed azonos modellszverzió mellett azonos képet eredményez.
lorasnem kötelező
Típusobject[]
Alapértelmezett[]
Azok a LoRA-k, amelyek együttes hatása létrehozza a generált képet; a megadható LoRA-k száma nincs korlátozva.
loras[].pathkötelező
Típusstring
A LoRA-súlyok helye URL-ként vagy elérési útként megadva.
loras[].scalenem kötelező
Típusobject | number
Alapértelmezett1
A LoRA-súlyokra alkalmazott skálázás, mielőtt összeolvadnak az alapmodellel. Az egyes rétegek skáláinak beállításához adjon meg {"layer_name":layer_scale} formátumú szótárat; a nem megadott rétegek 1.0 értéket használnak.
control_lorasnem kötelező
Típusobject[]
Alapértelmezett[]
A vezérlőképek LoRA-i egyetlen konfigurációba egyesítve a végső kép generálásához; a megadott szám korlátlan.
control_loras[].pathkötelező
Típusstring
A LoRA-súlyok helye URL-ként vagy elérési útként megadva.
control_loras[].scalenem kötelező
Típusobject | number
Alapértelmezett1
A LoRA-súlyokra alkalmazott skálázás, mielőtt összeolvadnak az alapmodellel. Az egyes rétegek skáláinak beállításához adjon meg {"layer_name":layer_scale} formátumú szótárat; a nem megadott rétegek 1.0 értéket használnak.
control_loras[].control_image_urlkötelező
Típusurl · image
A vezérlőképet biztosító kép URL-je.
control_loras[].preprocessnem kötelező
Típusenum
AlapértelmezettNone
cannydepthNone
A megadott képre alkalmazott előfeldolgozási módszer.
controlnetsnem kötelező
Típusobject[]
Alapértelmezett[]
ControlNet-konfiguráció képgeneráláshoz, jelenleg egyetlen ControlNetre korlátozva.
controlnets[].pathkötelező
Típusstring
A ControlNet súlyainak helye URL-ként vagy elérési útként.
controlnets[].config_urlnem kötelező
Típusstring | null
Opcionális URL, amely a ControlNet config.json fájljára mutat.
controlnets[].variantnem kötelező
Típusstring | null
Opcionális változat Hugging Face-repozitóriumkulccsal való használathoz.
controlnets[].control_image_urlkötelező
Típusurl · image
A vezérlőképet biztosító kép URL-je.
controlnets[].mask_image_urlnem kötelező
Típusurl · image
A vezérlőképhez társított maszk URL-je.
controlnets[].mask_thresholdnem kötelező
Típusnumber
Alapértelmezett0.5
0,01 – 0,99
Maszkküszöbérték.
controlnets[].conditioning_scalenem kötelező
Típusnumber
Alapértelmezett1
0 – 2
A ControlNet súlyaira alkalmazott skálázás, mielőtt összeolvadnak az alapmodellel.
controlnets[].start_percentagenem kötelező
Típusnumber
Alapértelmezett0
0 – 1
A teljes időlépésszám azon százaléka, amelynél a ControlNet hatást kezd gyakorolni a képgenerálásra.
controlnets[].end_percentagenem kötelező
Típusnumber
Alapértelmezett1
0 – 1
A teljes időlépésszám azon százaléka, amelynél a ControlNet abbahagyja a képgenerálás befolyásolását.
controlnet_unionsnem kötelező
Típusobject[]
Alapértelmezett[]
ControlNet union-konfiguráció képgeneráláshoz, az aktuális egyetlen-ControlNet korlátozás mellett.
controlnet_unions[].pathkötelező
Típusstring
A ControlNet súlyainak helye URL-ként vagy elérési útként.
controlnet_unions[].config_urlnem kötelező
Típusstring | null
Opcionális URL, amely a ControlNet config.json fájljára mutat.
controlnet_unions[].variantnem kötelező
Típusstring | null
Opcionális változat Hugging Face-repozitóriumkulccsal való használathoz.
controlnet_unions[].controlskötelező
Típusobject[]
A ControlNet számára megadott vezérlőképek és a hozzájuk tartozó módok.
controlnet_unions[].controls[].control_image_urlkötelező
Típusurl · image
A vezérlőképet biztosító kép URL-je.
controlnet_unions[].controls[].mask_image_urlnem kötelező
Típusurl · image
A vezérlőképhez társított maszk URL-je.
controlnet_unions[].controls[].control_modekötelező
Típusenum
cannytiledepthblurposegraylow-quality
A Flux Controlnet Union által használt vezérlési mód. Lehetőségek: a canny élekkel vezeti a generálást; a tile csempékkel; a depth szürkeárnyalatos mélységtérképpel; a blur elhomályosítja a képet; a pose a kép pózával vezeti a generálást; a gray szürkeárnyalatossá teszi a képet; a low-quality a kép gyenge minőségű változatát állítja elő.
controlnet_unions[].controls[].conditioning_scalenem kötelező
Típusnumber
Alapértelmezett1
0 – 2
A ControlNet súlyaira alkalmazott skálázás, mielőtt összeolvadnak az alapmodellel.
controlnet_unions[].controls[].mask_thresholdnem kötelező
Típusnumber
Alapértelmezett0.5
0,01 – 0,99
Maszkküszöbérték.
controlnet_unions[].controls[].start_percentagenem kötelező
Típusnumber
Alapértelmezett0
0 – 1
A teljes időlépésszám azon százaléka, amelynél a ControlNet hatást kezd gyakorolni a képgenerálásra.
controlnet_unions[].controls[].end_percentagenem kötelező
Típusnumber
Alapértelmezett1
0 – 1
A teljes időlépésszám azon százaléka, amelynél a ControlNet abbahagyja a képgenerálás befolyásolását.
ip_adaptersnem kötelező
Típusobject[]
Alapértelmezett[]
A képgenerálás során alkalmazott IP-Adapter.
ip_adapters[].pathkötelező
Típusstring
Az IP-Adapter helye a Hugging Face-en.
ip_adapters[].subfoldernem kötelező
Típusstring | null
Az ip_adapter súlyait tartalmazó almappa.
ip_adapters[].weight_namenem kötelező
Típusstring | null
Az IP-Adapter súlyainak Safetensors-fájlneve.
ip_adapters[].image_encoder_pathkötelező
Típusstring
Az IP-Adapter képkódolójának helye, például 'openai/clip-vit-large-patch14'.
ip_adapters[].image_encoder_subfoldernem kötelező
Típusstring | null
A képkódoló súlyait tartalmazó almappa.
ip_adapters[].image_encoder_weight_namenem kötelező
Típusstring | null
A képkódoló neve.
ip_adapters[].image_urlkötelező
Típusurl · image
Az IP-Adapter számára megadott kondicionáló kép URL-je.
ip_adapters[].mask_image_urlnem kötelező
Típusurl · image
A vezérlőképhez társított maszk URL-je.
ip_adapters[].mask_thresholdnem kötelező
Típusnumber
Alapértelmezett0.5
0,01 – 0,99
Maszkküszöbérték.
ip_adapters[].scalekötelező
Típusnumber
Az IP-Adapter skálázási tényezője.
easycontrolsnem kötelező
Típusobject[]
Alapértelmezett[]
A képgenerálás során alkalmazott EasyControl-bemenetek.
easycontrols[].control_method_urlkötelező
Típusstring
A vezérlési módszer safetensor-súlyának URL-je vagy támogatott azonosító: `canny`, `depth`, `hedsketch`, `inpainting`, `pose`, `seg`, `subject`, `ghibli`.
easycontrols[].scalenem kötelező
Típusnumber
Alapértelmezett1
0 – 2
A vezérlési módszer skálázási tényezője.
easycontrols[].image_urlkötelező
Típusurl · image
A vezérlőbemenetet biztosító kép URL-je.
easycontrols[].image_control_typekötelező
Típusenum
subjectspatial
Képvezérlési mód; értéke `spatial` vagy `subject` lehet.
fill_imagenem kötelező
Típusobject
A generálást vezérlő bemeneti kép, amely maszkolt területekhez is biztosíthat tartalmat.
fill_image.fill_image_urlnem kötelező
Típusurl · image
Alapértelmezett[]
A redux prompting segítségével kitöltendő képek URL-jei.
guidance_scalenem kötelező
Típusnumber
Alapértelmezett3.5
0 – 20
A kép kiválasztásának promptkövetési erőssége, CFG-ként (Classifier Free Guidance) megadva.
real_cfg_scalenem kötelező
Típusnumber
Alapértelmezett3.5
0 – 5
A kép kiválasztásának promptkövetési erőssége, CFG-ként (Classifier Free Guidance) megadva.
use_real_cfgnem kötelező
Típusboolean
Alapértelmezettfalse
Klasszikus CFG-kapcsoló, amely az XLabs IP-Adapter v1 esetén automatikusan engedélyezett. A vezérlési viselkedés az SD1.5 és SDXL modellekéhez hasonló.
use_cfg_zeronem kötelező
Típusboolean
Alapértelmezettfalse
Engedélyezi a CFG-zero inicializálású mintavételt, amelynek leírása: https://arxiv.org/abs/2503.18886.
num_imagesnem kötelező num_outputs
Típusinteger
Alapértelmezett1
1 – 10
A generálandó képek számának beállítása; streamelt kimenet esetén ez az érték mindig 1.
enable_safety_checkernem kötelező
Típusboolean
Alapértelmezetttrue
Biztonsági ellenőrzés, amely nem biztonságosnak jelölt képek helyett fekete képeket ad vissza. A true érték engedélyezi az ellenőrzést; a false csak jogosult fiókoknál kapcsolja ki, a jogosulatlan kéréseket pedig mindig ellenőrzi a rendszer.
reference_image_urlnem kötelező
Típusurl · image
A Reference-Only guidance számára használt kép URL-je.
reference_strengthnem kötelező
Típusnumber
Alapértelmezett0.65
-3 – 3
A referencia-kép hatása reference_only generálás során; megadott referencia-kép nélkül ez az erősségbeállítás nincs hatással az eredményre.
reference_startnem kötelező
Típusnumber
Alapértelmezett0
0 – 1
A referencia-vezérlés kezdőpontja az összes időlépés százalékában.
reference_endnem kötelező
Típusnumber
Alapértelmezett1
0 – 1
A referencia-vezérlés végpontja az összes időlépés százalékában.
base_shiftnem kötelező
Típusnumber
Alapértelmezett0.5
0,01 – 5
Az ütemezett időlépésekre alkalmazott alapeltolás.
max_shiftnem kötelező
Típusnumber
Alapértelmezett1.15
0,01 – 5
Az ütemezett időlépésekre alkalmazott maximális eltolás.
output_formatnem kötelező
Típusenum
Alapértelmezettpng
jpegpng
A létrejövő kép fájlformátuma.
use_beta_schedulenem kötelező
Típusboolean
Alapértelmezettfalse
Azt szabályozza, hogy használja-e a rendszer a béta-szigmákat.
sigma_schedulenem kötelező
Típusstring | null
A zajcsökkentés során használt szigmaütemezés.
schedulernem kötelező
Típusenum
Alapértelmezetteuler
eulerdpmpp_2m
A zajcsökkentés során használt ütemező.
negative_promptnem kötelező
Típusstring
Alapértelmezett
Alapértelmezés szerint NAG-gal feldolgozott negatív prompt, amely visszaszorítja a generált képekben megadott nem kívánt jellemzőket.
nag_scalenem kötelező
Típusnumber
Alapértelmezett3
≤ 10> 1
A negatív prompt elkerülését a NAG skálája szabályozza: növelése kevésbé teszi a generált képet a negatív leíráshoz hasonlóvá.
nag_taunem kötelező
Típusnumber
Alapértelmezett2.5
> 0
NAG tau-beállítás a rejtett állapot normalizálásához; ajánlott változatlanul hagyni. Növelése gyengíti a normalizálást, és az eredeti képtől való váratlan eltérések kockázatával jár.
nag_alphanem kötelező
Típusnumber
Alapértelmezett0.25
≤ 1> 0
A NAG alpha azt határozza meg, hogy a pozitív prompt mennyire irányítja át a pozitív és negatív promptot egyesítő normalizált vezérlést. Ez a végső súlyozás alacsonyabb értékeknél nagyobb hatást biztosít a pozitív promptnak, magasabb értékeknél pedig csökkenti az átirányítást.
nag_endnem kötelező
Típusnumber
Alapértelmezett0.25
≤ 1> 0
A NAG levágási pontja a generálási lépések arányaként megadva. A FLUX eredeti figyelemfeldolgozói azután veszik át a vezérlést, hogy a NAG lefutott ezen kezdeti arányon.
image_urlkötelező image
Típusurl · image
A kezdeti képet biztosító kép URL-je.
change_map_image_urlkötelező
Típusurl · image
A változástérképre mutató URL.
strengthnem kötelező
Típusnumber
Alapértelmezett0.85
0,01 – 1
Differenciális diffúziós erősség: 0.0 esetén az eredeti megőrzésétől 1.0 esetén teljes újragenerálásig terjed.
kötelező Kanonikus név, szintén elfogadva

A fájlparaméterek nyilvános https:// URL-t, legfeljebb 10 MB-os data: URI-t vagy egy feltöltés file_url értékét fogadják el. Fájlok

Kimenet

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "flux-general/differential-diffusion",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 138,
    "usd": "0.138",
    "charged": 138,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "change_map_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Az Ön fájljai, az Ön döntéseMinden outputs[].url a tárhelyünkön lévő másolat: örökre megőrizve (GB-hónaponként fizetve) vagy 7 nap ideig ingyenesen, a fiókbeállításod vagy a ?storage= alapján.
Azonos struktúra minden modellentype, url, content_type, width, height és duration képekhez, videókhoz és hanganyagokhoz egyaránt. Az output a modell saját eredményobjektuma.
A kimenet mezői
images
array of object {url, width, height, content_type}A generált képek fájlinformációi.
timings
object
seed
integerA képgenerálás seedje, beleértve a véletlenszerűen választott értéket, ha a bemenet nem tartalmazott seedet; egyébként a megadott értéket ismétli.
has_nsfw_concepts
array of booleanJelzi, hogy megjelennek-e NSFW-fogalmak a generált képeken.
prompt
stringA képgenerálás során használt prompt.

További modellek: Képszerkesztés

AI-ügynököknek: ez az oldal Markdown formátumban itt található: https://doitong.com/hu/developers/models/flux-general/differential-diffusion.md. Minden modell és útmutató: https://doitong.com/developers/llms.txt