Preskoči na vsebino

SDXL ControlNet Union · Image to Image

Integracija

ID modela sdxl-controlnet-union/image-to-image
# 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/image-to-image?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"
  }'

# 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"

Ta zahteva: ≈0,048 $ 48 API kreditov · ≈ 5,16 ₽ Zaženi na tej strani

Pridobi ključ API
Stability AI Urejanje slik #diffusion#controlnet#composition

SDXL za pretvorbo slike v sliko z vodenjem več ControlNetov iz kontrolnih slik poze, globine, robov, normal ali segmentacije

Stability AI · Slika

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

•obvezno

Opišite sliko, ki jo želite ustvariti, in uporabite čim več podrobnosti za najboljše rezultate.

•obvezno image_url
Spustite datoteko ali

Začetna slika za generiranje, posredovana z URL-jem.

image_size

Mere izhoda, samodejno določene iz kontrolne slike, če velikost ni navedena.

num_images privzeto 1

Število slik, zahtevanih za generiranje.

Napredno 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 · preserve_aspect_ratio · crop_output · openpose_preprocess · depth_preprocess · teed_preprocess · canny_preprocess · normal_preprocess · segmentation_preprocess · loras · embeddings
privzeto

Negativni poziv, ki določa neželene podrobnosti slike. Izključi lahko barve, predmete, pokrajino ali drobnejše značilnosti in kakovosti, kot so brki, zamegljenost ali nizka ločljivost.

Spustite datoteko ali

URL kontrolne slike.

Spustite datoteko ali

URL kontrolne slike.

Spustite datoteko ali

URL kontrolne slike.

Spustite datoteko ali

URL kontrolne slike.

Spustite datoteko ali

URL kontrolne slike.

Spustite datoteko ali

URL kontrolne slike.

safety_checker_version privzeto v1

Izberite med varnostnim preverjalnikom ViT po meri (`v2`) in preverjalnikom CompVis (`v1`, privzeto).

format privzeto jpeg

Oblika datoteke končne slike.

privzeto

Identifikator zahteve za povezovanje odgovora z zahtevo, ki ga je ustvarila.

privzeto 0.5

Moč pogojevanja, uporabljenega s ControlNet.

privzeto 35

Število korakov sklepanja, ki jih je treba izvesti.

privzeto 7.5

Jakost upoštevanja poziva pri izbiri slike, izražena kot CFG (Classifier Free Guidance).

privzeto 0.95

Stopnja podobnosti med ustvarjeno in začetno sliko.

Seme za poustvarjanje slik v Stable Diffusion. Sliko je mogoče pri vsakem zagonu popolnoma poustvariti, če ostanejo različica modela, poziv in seme nespremenjeni.

privzeto []

Uteži LoRA, izbrane za uporabo, podane kot seznam.

privzeto []

Vdelave, izbrane za uporabo, podane kot seznam.

POST /run/sdxl-controlnet-union/image-to-image?wait=20 cena → 0,048 $
# 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/image-to-image?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"
  }'

# 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"

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu SDXL ControlNet Union · Image to Image

Preoblikuje začetno sliko z osnovo SDXL, ki jo usmerjata poziv in neobvezne kontrolne slike za openpose, globinsko sliko, teed, canny, normal in segmentacija. Vsak kontrolni vhod ima svoje stikalo za predobdelavo. `strength` sega od 0.05 do 1, `num_inference_steps` od 1 do 70, pri vsakem klicu pa je mogoče vrniti do 8 slik. Dodate lahko LoRA in vložitve, izhod pa je jpeg ali png.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis
promptobvezno
Vrstastring
Opišite sliko, ki jo želite ustvariti, in uporabite čim več podrobnosti za najboljše rezultate.
controlnet_conditioning_scaleneobvezno
Vrstanumber
Privzeto0.5
0 – 1
Moč pogojevanja, uporabljenega s ControlNet.
image_urlobvezno image
Vrstaurl · image
Začetna slika za generiranje, posredovana z URL-jem.
negative_promptneobvezno
Vrstastring
Privzeto
Negativni poziv, ki določa neželene podrobnosti slike. Izključi lahko barve, predmete, pokrajino ali drobnejše značilnosti in kakovosti, kot so brki, zamegljenost ali nizka ločljivost.
image_sizeneobvezno
Vrstaobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Mere izhoda, samodejno določene iz kontrolne slike, če velikost ni navedena.
num_inference_stepsneobvezno
Vrstainteger
Privzeto35
1 – 70
Število korakov sklepanja, ki jih je treba izvesti.
guidance_scaleneobvezno
Vrstanumber
Privzeto7.5
0 – 20
Jakost upoštevanja poziva pri izbiri slike, izražena kot CFG (Classifier Free Guidance).
strengthneobvezno
Vrstanumber
Privzeto0.95
0,05 – 1
Stopnja podobnosti med ustvarjeno in začetno sliko.
seedneobvezno
Vrstainteger | null
Seme za poustvarjanje slik v Stable Diffusion. Sliko je mogoče pri vsakem zagonu popolnoma poustvariti, če ostanejo različica modela, poziv in seme nespremenjeni.
num_imagesneobvezno num_outputs
Vrstainteger
Privzeto1
1 – 8
Število slik, zahtevanih za generiranje.
lorasneobvezno
Vrstaobject[]
Privzeto[]
Uteži LoRA, izbrane za uporabo, podane kot seznam.
loras[].forceneobvezno
Vrstaboolean
Privzetofalse
Ali je uporaba vdelav obvezna: true jo naredi obvezno.
loras[].pathobvezno
Vrstastring
Vir uteži LoRA, podan kot identifikator modela HF, ki se razreši v uteži safetensors, ali kot datoteka safetensors, najdena prek URL-ja ali poti.
loras[].scaleneobvezno
Vrstanumber
Privzeto1
0 – 1
Množilnik, uporabljen za utež LoRA, preden se združi z osnovnim modelom.
embeddingsneobvezno
Vrstaobject[]
Privzeto[]
Vdelave, izbrane za uporabo, podane kot seznam.
embeddings[].pathobvezno
Vrstastring
Uteži vdelave, določene z URL-jem ali potjo datoteke.
embeddings[].tokensneobvezno
Vrstastring[]
Seznam žetonov vdelave; če ni podan, je na voljo samodejno poimenovanje: vsak vektor v datoteki vdelave prejme žeton iz zaporedja <s0>, <s1>, ... .
enable_safety_checkerneobvezno
Vrstaboolean
Privzetotrue
Aktivacija varnostnega preverjanja; true omogoči preverjanje.
safety_checker_versionneobvezno
Vrstaenum
Privzetov1
v1v2
Izberite med varnostnim preverjalnikom ViT po meri (`v2`) in preverjalnikom CompVis (`v1`, privzeto).
expand_promptneobvezno
Vrstaboolean
Privzetofalse
Razširitev poziva z dodatnimi pozivi, omogočena, ko je vrednost true.
formatneobvezno
Vrstaenum
Privzetojpeg
jpegpng
Oblika datoteke končne slike.
request_idneobvezno
Vrstastring
Privzeto
Identifikator zahteve za povezovanje odgovora z zahtevo, ki ga je ustvarila.
preserve_aspect_rationeobvezno
Vrstaboolean
Privzetofalse
Nastavite na true, da ohranite razmerje stranic ustvarjene slike, tudi ko njena velikost preseže omejitev. Za pravilna razmerja z obrezovanjem po generiranju nastavite crop_output na True. Vrednosti širine ali višine, ki niso deljive z 32, se še vedno zaokrožijo na najbližji večkratnik 32; to spreminjanje velikosti privzeto ne ohrani razmerja stranic.
crop_outputneobvezno
Vrstaboolean
Privzetofalse
Ko je true, obreži ustvarjeni izhod na pravilno razmerje stranic.
openpose_image_urlneobvezno
Vrstaurl · image
URL kontrolne slike.
openpose_preprocessneobvezno
Vrstaboolean
Privzetotrue
Nadzira predobdelavo slike openpose.
depth_image_urlneobvezno
Vrstaurl · image
URL kontrolne slike.
depth_preprocessneobvezno
Vrstaboolean
Privzetotrue
Nadzira predobdelavo slike depth.
teed_image_urlneobvezno
Vrstaurl · image
URL kontrolne slike.
teed_preprocessneobvezno
Vrstaboolean
Privzetotrue
Nadzira predobdelavo slike teed.
canny_image_urlneobvezno
Vrstaurl · image
URL kontrolne slike.
canny_preprocessneobvezno
Vrstaboolean
Privzetotrue
Nadzira predobdelavo slike canny.
normal_image_urlneobvezno
Vrstaurl · image
URL kontrolne slike.
normal_preprocessneobvezno
Vrstaboolean
Privzetotrue
Nadzira predobdelavo slike normal.
segmentation_image_urlneobvezno
Vrstaurl · image
URL kontrolne slike.
segmentation_preprocessneobvezno
Vrstaboolean
Privzetotrue
Nadzira predobdelavo slike segmentacije.
obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sdxl-controlnet-union/image-to-image",
  "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": 48,
    "usd": "0.048",
    "charged": 48,
    "refunded": 0
  },
  "input": {
    "image_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"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
images
array of object {url, width, height, content_type}Podatki o datotekah ustvarjenih slik.
timings
object
seed
integerSeme za generiranje slike, vključno z naključno izbrano vrednostjo, če vhod ni vseboval semena; sicer ponovi podano vrednost.
has_nsfw_concepts
array of booleanOznačuje, ali se v generiranih slikah pojavljajo koncepti NSFW.
prompt
stringPoziv, uporabljen pri generiranju slike.

Več modelov: Urejanje slik

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/sdxl-controlnet-union/image-to-image.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt