Siirry sisältöön

SDXL ControlNet Union · Inpainting

Integroi

Mallin tunniste sdxl-controlnet-union/inpainting
# 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/inpainting?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",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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,012 $ 12 API-krediittiä · ≈ 1,29 ₽ Suorita tällä sivulla

Hanki API-avain
Stability AI Kuvan muokkaus #diffusion#controlnet#composition

SDXL inpainting, joka täyttää maskatun alueen asento-, syvyyskartta-, edge- tai muiden ControlNet-ohjainten perusteella

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.

•pakollinen image_url
Pudota tiedosto tai

Generoinnin aloituskuva URL-osoitteena.

•pakollinen mask_url
Pudota tiedosto tai

Inpainting-maskin URL-osoite.

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 · strength · 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ää ei-toivotut kuvan yksityiskohdat. Sillä voi sulkea pois värejä, objekteja, maisemia tai hienompia piirteitä ja ominaisuuksia, kuten viikset, sumennuksen tai matalan resoluution.

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).

oletus 0.95

Luodun kuvan ja alkuperäisen kuvan samankaltaisuuden aste.

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/inpainting?wait=20 hinta → 0,012 $
# 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/inpainting?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",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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 · Inpainting

Maalaa vain lähteen `image_url` parametrilla `mask_url` merkityn alueen kehotteen ohjaamana. Valinnaiset openpose-, syvyyskartta-, teed-, canny-, normal- ja segmentation-ohjauskuvat ohjaavat tulosta, ja kullakin on oma esikäsittelyn valintansa. `strength` hyväksyy arvot välillä 0.01–1, askelten määrä voi olla enintään 70, ja pyyntö voi tuottaa enintään 8 kuvaa. LoRA-parametreja, upotuksia sekä jpeg- tai png-tulostetta tuetaan.

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.
image_urlpakollinen image
Tyyppiurl · image
Generoinnin aloituskuva URL-osoitteena.
mask_urlpakollinen mask
Tyyppiurl · image
Inpainting-maskin URL-osoite.
negative_promptvalinnainen
Tyyppistring
Oletus
Negatiivinen kehote, joka määrittää ei-toivotut kuvan yksityiskohdat. Sillä voi sulkea pois värejä, objekteja, maisemia tai hienompia piirteitä ja ominaisuuksia, kuten viikset, sumennuksen tai matalan resoluution.
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ä.
guidance_scalevalinnainen
Tyyppinumber
Oletus7.5
0 – 20
Kuvan valinnan kehotteenmukaisuuden voimakkuus, ilmaistuna CFG:nä (Classifier Free Guidance).
strengthvalinnainen
Tyyppinumber
Oletus0.95
0,01 – 1
Luodun kuvan ja alkuperäisen kuvan samankaltaisuuden aste.
seedvalinnainen
Tyyppiinteger | null
Siemen kuvien toistamiseen Stable Diffusionissa. Kuva voidaan toistaa täsmälleen jokaisella suorituskerralla pitämällä malliversio, kehote ja siemen muuttumattomina.
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/inpainting",
  "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": 12,
    "usd": "0.012",
    "charged": 12,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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: Kuvan muokkaus

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