Siirry sisältöön

SDXL ControlNet Union

Integroi

Mallin tunniste 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Tämä pyyntö: ≈0,014 $ 14 API-krediittiä · ≈ 1,48 ₽ Suorita tällä sivulla

Hanki API-avain
Stability AI Tekstistä kuvaksi #diffusion#controlnet#composition

SDXL-teksti kuvaksi -malli, jota ohjaa enintään kuusi ohjauskuvaa: openpose, syvyyskartta, teed, canny, normal, segmentointi

Stability AI · Kuva

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen

Kuvaile haluamasi generoitava kuva mahdollisimman yksityiskohtaisesti parhaan tuloksen saamiseksi.

image_size

Tulosteen mitat, jotka määritetään automaattisesti ohjauskuvasta, jos kokoa ei anneta.

num_images oletus 1

Generoitavien kuvien määrä.

Lisäasetukset 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
oletus

Negatiivinen kehote, joka määrittää kuvasta poissuljettavat yksityiskohdat, kuten värit, objektit, maisemat tai hienommat piirteet. Esimerkkejä ovat viikset, sumennus tai matala resoluutio.

Pudota tiedosto tai

Ohjauskuvan URL-osoite.

Pudota tiedosto tai

Ohjauskuvan URL-osoite.

Pudota tiedosto tai

Ohjauskuvan URL-osoite.

Pudota tiedosto tai

Ohjauskuvan URL-osoite.

Pudota tiedosto tai

Ohjauskuvan URL-osoite.

Pudota tiedosto tai

Ohjauskuvan URL-osoite.

safety_checker_version oletus v1

Valitse mukautetun ViT-turvatarkistimen (`v2`) ja CompVis-tarkistimen (`v1`, oletus) välillä.

format oletus jpeg

Tulostekuvan tiedostomuoto.

oletus

Pyynnön tunniste, jolla vastaus yhdistetään sen tuottaneeseen pyyntöön.

oletus 0.5

ControlNetin käyttämän ehdollistuksen voimakkuus.

oletus 35

Suoritettavien päättelyvaiheiden määrä.

oletus 7.5

Kuvan valinnan kehotteenmukaisuuden voimakkuus, ilmaistuna CFG:nä (Classifier Free Guidance).

Siemen kuvien toistamiseen Stable Diffusionissa. Kuva voidaan toistaa täsmälleen jokaisella suorituskerralla pitämällä malliversio, kehote ja siemen muuttumattomina.

oletus []

Käyttöön valitut LoRA-painot luettelona.

oletus []

Käyttöön valitut upotukset luettelona.

POST /run/sdxl-controlnet-union?wait=20 hinta → 0,014 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: SDXL ControlNet Union

Luo SDXL-kuvia `prompt`-kehotteesta, jota ohjaavat esimerkiksi openpose-, syvyyskartta-, teed-, canny-, normal- tai segmentation-kuvat, joista kullakin on oma esikäsittelyn valintansa. `controlnet_conditioning_scale` vaihtelee välillä 0–1. Kuvan koko voidaan päätellä ohjauskuvasta. Tukee LoRA-parametreja, upotuksia, 1–8 kuvaa sekä jpeg- tai png-tulostetta.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
promptpakollinen
Tyyppistring
Kuvaile haluamasi generoitava kuva mahdollisimman yksityiskohtaisesti parhaan tuloksen saamiseksi.
controlnet_conditioning_scalevalinnainen
Tyyppinumber
Oletus0.5
0 – 1
ControlNetin käyttämän ehdollistuksen voimakkuus.
negative_promptvalinnainen
Tyyppistring
Oletus
Negatiivinen kehote, joka määrittää kuvasta poissuljettavat yksityiskohdat, kuten värit, objektit, maisemat tai hienommat piirteet. Esimerkkejä ovat viikset, sumennus tai matala resoluutio.
image_sizevalinnainen
Tyyppiobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Tulosteen mitat, jotka määritetään automaattisesti ohjauskuvasta, jos kokoa ei anneta.
num_inference_stepsvalinnainen
Tyyppiinteger
Oletus35
1 – 70
Suoritettavien päättelyvaiheiden määrä.
seedvalinnainen
Tyyppiinteger | null
Siemen kuvien toistamiseen Stable Diffusionissa. Kuva voidaan toistaa täsmälleen jokaisella suorituskerralla pitämällä malliversio, kehote ja siemen muuttumattomina.
guidance_scalevalinnainen
Tyyppinumber
Oletus7.5
0 – 20
Kuvan valinnan kehotteenmukaisuuden voimakkuus, ilmaistuna CFG:nä (Classifier Free Guidance).
num_imagesvalinnainen num_outputs
Tyyppiinteger
Oletus1
1 – 8
Generoitavien kuvien määrä.
lorasvalinnainen
Tyyppiobject[]
Oletus[]
Käyttöön valitut LoRA-painot luettelona.
loras[].forcevalinnainen
Tyyppiboolean
Oletusfalse
Onko upotusten käyttö pakollista: true tekee siitä pakollista.
loras[].pathpakollinen
Tyyppistring
LoRA-painojen lähde, joka annetaan HF-mallitunnisteena safetensors-painoihin tai URL-osoitteen tai polun kautta sijaitsevana safetensors-tiedostona.
loras[].scalevalinnainen
Tyyppinumber
Oletus1
0 – 1
LoRA-painoon käytettävä kerroin ennen sen yhdistämistä perusmalliin.
embeddingsvalinnainen
Tyyppiobject[]
Oletus[]
Käyttöön valitut upotukset luettelona.
embeddings[].pathpakollinen
Tyyppistring
URL-osoitteella tai tiedostopolulla määritetyt upotuspainot.
embeddings[].tokensvalinnainen
Tyyppistring[]
Upotussanakkeiden luettelo; nimen puuttuessa käytetään automaattista nimeämistä: jokainen upotustiedoston vektori saa sanakkeen sarjasta <s0>, <s1>, ... .
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Turvatarkistuksen aktivointi; true ottaa tarkistuksen käyttöön.
safety_checker_versionvalinnainen
Tyyppienum
Oletusv1
v1v2
Valitse mukautetun ViT-turvatarkistimen (`v2`) ja CompVis-tarkistimen (`v1`, oletus) välillä.
expand_promptvalinnainen
Tyyppiboolean
Oletusfalse
Kehotteen laajennus lisäkehotteilla, käytössä kun arvo on true.
formatvalinnainen
Tyyppienum
Oletusjpeg
jpegpng
Tulostekuvan tiedostomuoto.
request_idvalinnainen
Tyyppistring
Oletus
Pyynnön tunniste, jolla vastaus yhdistetään sen tuottaneeseen pyyntöön.
openpose_image_urlvalinnainen
Tyyppiurl · image
Ohjauskuvan URL-osoite.
openpose_preprocessvalinnainen
Tyyppiboolean
Oletustrue
Ohjaa openpose-kuvan esikäsittelyä.
depth_image_urlvalinnainen
Tyyppiurl · image
Ohjauskuvan URL-osoite.
depth_preprocessvalinnainen
Tyyppiboolean
Oletustrue
Ohjaa syvyyskuvan esikäsittelyä.
teed_image_urlvalinnainen
Tyyppiurl · image
Ohjauskuvan URL-osoite.
teed_preprocessvalinnainen
Tyyppiboolean
Oletustrue
Ohjaa teed-kuvan esikäsittelyä.
canny_image_urlvalinnainen
Tyyppiurl · image
Ohjauskuvan URL-osoite.
canny_preprocessvalinnainen
Tyyppiboolean
Oletustrue
Ohjaa canny-kuvan esikäsittelyä.
normal_image_urlvalinnainen
Tyyppiurl · image
Ohjauskuvan URL-osoite.
normal_preprocessvalinnainen
Tyyppiboolean
Oletustrue
Ohjaa normal-kuvan esikäsittelyä.
segmentation_image_urlvalinnainen
Tyyppiurl · image
Ohjauskuvan URL-osoite.
segmentation_preprocessvalinnainen
Tyyppiboolean
Oletustrue
Ohjaa segmentointikuvan esikäsittelyä.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
images
array of object {url, width, height, content_type}Generoitujen kuvien tiedostotiedot.
timings
object
seed
integerKuvageneroinnin siemen, mukaan lukien satunnaisesti valittu arvo, jos syötteessä ei annettu siementä; muuten annettu arvo toistetaan.
has_nsfw_concepts
array of booleanIlmaisee, esiintyykö generoiduissa kuvissa NSFW-sisältöä.
prompt
stringKuvan generoinnissa käytettävä kehote.

Lisää malleja: Tekstistä kuvaksi

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/sdxl-controlnet-union.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt