Pereiti prie turinio

SDXL ControlNet Union

Integruoti

Modelio id sdxl-controlnet-union
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/sdxl-controlnet-union?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"
  }'

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

Ši užklausa: ≈0,014 $ 14 API kreditų Paleisti šiame puslapyje

Gauti API raktą
Stability AI Tekstas į vaizdą #diffusion#controlnet#composition

SDXL teksto į vaizdą generavimas, valdomas iki šešių valdymo vaizdų: openpose, gylio žemėlapis, teed, canny, normal, segmentavimas

Stability AI · Vaizdas

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma

Kuo išsamiau aprašykite norimą sugeneruoti vaizdą, kad gautumėte geriausius rezultatus.

image_size

Išvesties matmenys, automatiškai nustatomi pagal valdymo vaizdą, jei dydis nepateiktas.

num_images numatytoji 1

Generavimui prašomas vaizdų skaičius.

Išplėstiniai negative_prompt · openpose_image_url · depth_image_url · teed_image_url · canny_image_url · normal_image_url · segmentation_image_url · safety_checker_version · format · request_id · controlnet_conditioning_scale · num_inference_steps · guidance_scale · seed · enable_safety_checker · expand_prompt · openpose_preprocess · depth_preprocess · teed_preprocess · canny_preprocess · normal_preprocess · segmentation_preprocess · loras · embeddings
numatytoji

Neigiamas raginys, nurodantis neįtrauktinas vaizdo detales, įskaitant spalvas, objektus, aplinką ar smulkesnius bruožus. Pavyzdžiai: ūsai, suliejimas arba maža raiška.

Įmeskite failą arba

URL, nurodantis valdymo vaizdą.

Įmeskite failą arba

URL, nurodantis valdymo vaizdą.

Įmeskite failą arba

URL, nurodantis valdymo vaizdą.

Įmeskite failą arba

URL, nurodantis valdymo vaizdą.

Įmeskite failą arba

URL, nurodantis valdymo vaizdą.

Įmeskite failą arba

URL, nurodantis valdymo vaizdą.

safety_checker_version numatytoji v1

Pasirinkite pasirinktinį ViT saugos tikrintuvą (`v2`) arba CompVis tikrintuvą (`v1`, numatytasis).

format numatytoji jpeg

Galutinio vaizdo failo formatas.

numatytoji

Užklausos identifikatorius atsakymui susieti su jį sukūrusia užklausa.

numatytoji 0.5

ControlNet taikomo sąlygojimo stiprumas.

numatytoji 35

Atliekamų išvedimo žingsnių skaičius.

numatytoji 7.5

Raginio laikymosi stiprumas vaizdo parinkimui, išreikštas kaip CFG (Classifier Free Guidance).

Pradinis skaičius vaizdams atkurti Stable Diffusion. Vaizdą galima tiksliai atkurti kiekvieno paleidimo metu, jei nekeičiama modelio versija, raginys ir pradinis skaičius.

numatytoji []

Naudoti pasirinkti LoRA svoriai, pateikti kaip sąrašas.

numatytoji []

Naudoti pasirinkti įdėčiai, pateikti kaip sąrašas.

POST /run/sdxl-controlnet-union?wait=20 kaina → 0,014 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/sdxl-controlnet-union?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"
  }'

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

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie SDXL ControlNet Union

Generuoja SDXL vaizdus iš `prompt`, valdomo tokiais valdymo vaizdais kaip openpose, gylio žemėlapis, teed, canny, normal arba segmentavimas, kurių kiekvienas turi atskirą išankstinio apdorojimo jungiklį. `controlnet_conditioning_scale` svyruoja nuo 0 iki 1. Vaizdo dydis gali būti nustatytas pagal valdymo vaizdą. Palaikomos LoRA, įterpiniai, nuo 1 iki 8 vaizdų ir jpeg arba png išvestis.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
promptprivaloma
Tipasstring
Kuo išsamiau aprašykite norimą sugeneruoti vaizdą, kad gautumėte geriausius rezultatus.
controlnet_conditioning_scaleneprivalomas
Tipasnumber
Numatytoji reikšmė0.5
0 – 1
ControlNet taikomo sąlygojimo stiprumas.
negative_promptneprivalomas
Tipasstring
Numatytoji reikšmė
Neigiamas raginys, nurodantis neįtrauktinas vaizdo detales, įskaitant spalvas, objektus, aplinką ar smulkesnius bruožus. Pavyzdžiai: ūsai, suliejimas arba maža raiška.
image_sizeneprivalomas
Tipasobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Išvesties matmenys, automatiškai nustatomi pagal valdymo vaizdą, jei dydis nepateiktas.
num_inference_stepsneprivalomas
Tipasinteger
Numatytoji reikšmė35
1 – 70
Atliekamų išvedimo žingsnių skaičius.
seedneprivalomas
Tipasinteger | null
Pradinis skaičius vaizdams atkurti Stable Diffusion. Vaizdą galima tiksliai atkurti kiekvieno paleidimo metu, jei nekeičiama modelio versija, raginys ir pradinis skaičius.
guidance_scaleneprivalomas
Tipasnumber
Numatytoji reikšmė7.5
0 – 20
Raginio laikymosi stiprumas vaizdo parinkimui, išreikštas kaip CFG (Classifier Free Guidance).
num_imagesneprivalomas num_outputs
Tipasinteger
Numatytoji reikšmė1
1 – 8
Generavimui prašomas vaizdų skaičius.
lorasneprivalomas
Tipasobject[]
Numatytoji reikšmė[]
Naudoti pasirinkti LoRA svoriai, pateikti kaip sąrašas.
loras[].forceneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Ar įdėčių naudojimas privalomas: true reiškia, kad jis privalomas.
loras[].pathprivaloma
Tipasstring
LoRA svorių šaltinis, pateikiamas kaip HF modelio identifikatorius, nurodantis į safetensors svorius, arba kaip URL ar keliu pasiekiamas safetensors failas.
loras[].scaleneprivalomas
Tipasnumber
Numatytoji reikšmė1
0 – 1
Daugiklis, taikomas LoRA svoriui prieš jį sujungiant su baziniu modeliu.
embeddingsneprivalomas
Tipasobject[]
Numatytoji reikšmė[]
Naudoti pasirinkti įdėčiai, pateikti kaip sąrašas.
embeddings[].pathprivaloma
Tipasstring
Įdėties svoriai, nurodyti URL arba failo keliu.
embeddings[].tokensneprivalomas
Tipasstring[]
Įdėties žetonų sąrašas; jo nepateikus naudojami automatiniai pavadinimai: kiekvienas įdėties faile esantis vektorius gauna sekos <s0>, <s1>, ... žetoną.
enable_safety_checkerneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Saugos tikrintuvo aktyvinimas; true įjungia tikrinimą.
safety_checker_versionneprivalomas
Tipasenum
Numatytoji reikšmėv1
v1v2
Pasirinkite pasirinktinį ViT saugos tikrintuvą (`v2`) arba CompVis tikrintuvą (`v1`, numatytasis).
expand_promptneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Raginio išplėtimas papildomais raginiais, įjungiamas, kai true.
formatneprivalomas
Tipasenum
Numatytoji reikšmėjpeg
jpegpng
Galutinio vaizdo failo formatas.
request_idneprivalomas
Tipasstring
Numatytoji reikšmė
Užklausos identifikatorius atsakymui susieti su jį sukūrusia užklausa.
openpose_image_urlneprivalomas
Tipasurl · image
URL, nurodantis valdymo vaizdą.
openpose_preprocessneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Valdo openpose vaizdo išankstinį apdorojimą.
depth_image_urlneprivalomas
Tipasurl · image
URL, nurodantis valdymo vaizdą.
depth_preprocessneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Valdo gylio vaizdo išankstinį apdorojimą.
teed_image_urlneprivalomas
Tipasurl · image
URL, nurodantis valdymo vaizdą.
teed_preprocessneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Valdo teed vaizdo išankstinį apdorojimą.
canny_image_urlneprivalomas
Tipasurl · image
URL, nurodantis valdymo vaizdą.
canny_preprocessneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Valdo canny vaizdo išankstinį apdorojimą.
normal_image_urlneprivalomas
Tipasurl · image
URL, nurodantis valdymo vaizdą.
normal_preprocessneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Valdo normal vaizdo išankstinį apdorojimą.
segmentation_image_urlneprivalomas
Tipasurl · image
URL, nurodantis valdymo vaizdą.
segmentation_preprocessneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Valdo segmentavimo vaizdo išankstinį apdorojimą.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sdxl-controlnet-union",
  "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": 14,
    "usd": "0.014",
    "charged": 14,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
images
array of object {url, width, height, content_type}Sugeneruotų vaizdų failo informacija.
timings
object
seed
integerVaizdo generavimo pradinė reikšmė, įskaitant atsitiktinai parinktą reikšmę, jei įvestyje pradinė reikšmė nenurodyta; kitu atveju kartojama pateikta reikšmė.
has_nsfw_concepts
array of booleanNurodo, ar sugeneruotuose vaizduose yra NSFW sąvokų.
prompt
stringVaizdo generavimo metu naudojamas raginys.

Daugiau modelių: Tekstas į vaizdą

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/sdxl-controlnet-union.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt