Léim chuig an ábhar

SDXL ControlNet Union

Comhtháthú

Aitheantas na samhla 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"

An t-iarratas seo: ≈$0.014 14 gcreidmheas API · ≈ ₽1.47 Rith ar an leathanach seo

Faigh eochair API
Stability AI Téacs go hÍomhá #diffusion#controlnet#composition

Téacs-go-íomhá SDXL faoi threoir suas le sé íomhá rialaithe: openpose, mapa doimhneachta, teed, canny, normal, deighilt

Stability AI · Íomhá

Beidh do chéad toradh anseo

Tóg iarratas thíos agus rith é le d’eochair API. Cóipeáiltear na haschuir chuig ár stóráil, coinnithe go deo nó ar feadh 7 lá saor in aisce.

Tóg iarratas

Gintear na rialtáin ó scéim na samhla. Nuashonraítear an cód agus an praghas de réir mar a athraíonn tú iad.

•riachtanach

Déan cur síos ar an íomhá atá uait a ghiniúint, agus bain úsáid as an oiread sonraí agus is féidir chun na torthaí is fearr a fháil.

image_size

Toisí aschuir, a chinntear go huathoibríoch ón íomhá rialaithe nuair nach soláthraítear méid.

num_images réamhshocrú 1

Líon na n-íomhánna a iarrtar don ghiniúint.

Ardleibhéal 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
réamhshocrú

Leid dhiúltach ina sonraítear sonraí íomhá atá le heisiamh, lena n-áirítear dathanna, réada, radhairc nó gnéithe míne. I measc na samplaí tá mustache, doiléireacht nó taifeach íseal.

Scaoil comhad, nó

URL a dhíríonn ar an íomhá rialaithe.

Scaoil comhad, nó

URL a dhíríonn ar an íomhá rialaithe.

Scaoil comhad, nó

URL a dhíríonn ar an íomhá rialaithe.

Scaoil comhad, nó

URL a dhíríonn ar an íomhá rialaithe.

Scaoil comhad, nó

URL a dhíríonn ar an íomhá rialaithe.

Scaoil comhad, nó

URL a dhíríonn ar an íomhá rialaithe.

safety_checker_version réamhshocrú v1

Roghnaigh idir seiceálaí sábháilteachta saincheaptha ViT (`v2`) agus seiceálaí CompVis (`v1`, an réamhshocrú).

format réamhshocrú jpeg

Formáid comhaid na híomhá deiridh.

réamhshocrú

Aitheantóir iarratais chun freagairt a chomhghaolú leis an iarratas a chruthaigh í.

réamhshocrú 0.5

Neart an oiriúnaithe a chuireann ControlNet i bhfeidhm.

réamhshocrú 35

Líon na gcéimeanna tátail atá le rith.

réamhshocrú 7.5

Neart cloí leis an leid agus íomhánna á roghnú, léirithe mar CFG (Classifier Free Guidance).

Síol chun íomhánna a athchruthú in Stable Diffusion. Is féidir íomhá a athchruthú go beacht i ngach rith trí leagan na samhla, an leid agus an síol a choinneáil gan athrú.

réamhshocrú []

Meáchain LoRA roghnaithe le húsáid, curtha ar fáil mar liosta.

réamhshocrú []

Leabaithe roghnaithe le húsáid, curtha ar fáil mar liosta.

POST /run/sdxl-controlnet-union?wait=20 luachan → $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"

Rith an t-iarratas seo

Fanann d'eochair sa bhrabhsálaí seo: seoltar chuig Doitong API amháin í agus sábháiltear (localStorage) í ach amháin má chuireann tú tic le Meabhraigh. Faigh eochair API

Maidir le SDXL ControlNet Union

Gineann sé íomhánna SDXL ó `prompt` arna stiúradh ag íomhánna rialaithe amhail openpose, mapa doimhneachta, teed, canny, normal nó deighilt, agus scorán réamhphróiseála dá chuid féin ag gach ceann. Raonta `controlnet_conditioning_scale` ó 0 go 1. Is féidir méid na híomhá a bhaint as an íomhá rialaithe. Tacaíonn sé le LoRAs, leabuithe, 1 go 8 n-íomhá agus aschur jpeg nó png.

Paraiméadair

Seol an t-ainm canónach nó an t-ainm dúchasach, ní an dá cheann. Ainmneacha canónacha

AinmCineál RéamhshocrúCeadaithe Cur síos
promptriachtanach
Cineálstring
Déan cur síos ar an íomhá atá uait a ghiniúint, agus bain úsáid as an oiread sonraí agus is féidir chun na torthaí is fearr a fháil.
controlnet_conditioning_scaleroghnach
Cineálnumber
Réamhshocrú0.5
0 – 1
Neart an oiriúnaithe a chuireann ControlNet i bhfeidhm.
negative_promptroghnach
Cineálstring
Réamhshocrú
Leid dhiúltach ina sonraítear sonraí íomhá atá le heisiamh, lena n-áirítear dathanna, réada, radhairc nó gnéithe míne. I measc na samplaí tá mustache, doiléireacht nó taifeach íseal.
image_sizeroghnach
Cineálobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Toisí aschuir, a chinntear go huathoibríoch ón íomhá rialaithe nuair nach soláthraítear méid.
num_inference_stepsroghnach
Cineálinteger
Réamhshocrú35
1 – 70
Líon na gcéimeanna tátail atá le rith.
seedroghnach
Cineálinteger | null
Síol chun íomhánna a athchruthú in Stable Diffusion. Is féidir íomhá a athchruthú go beacht i ngach rith trí leagan na samhla, an leid agus an síol a choinneáil gan athrú.
guidance_scaleroghnach
Cineálnumber
Réamhshocrú7.5
0 – 20
Neart cloí leis an leid agus íomhánna á roghnú, léirithe mar CFG (Classifier Free Guidance).
num_imagesroghnach num_outputs
Cineálinteger
Réamhshocrú1
1 – 8
Líon na n-íomhánna a iarrtar don ghiniúint.
lorasroghnach
Cineálobject[]
Réamhshocrú[]
Meáchain LoRA roghnaithe le húsáid, curtha ar fáil mar liosta.
loras[].forceroghnach
Cineálboolean
Réamhshocrúfalse
An bhfuil úsáid an leabaithe éigeantach: déanann true éigeantach é.
loras[].pathriachtanach
Cineálstring
Foinse mheáchain LoRA, soláthraithe mar aitheantóir samhla HF a réitíonn chuig meáchain safetensors, nó mar chomhad safetensors suite trí URL nó conair.
loras[].scaleroghnach
Cineálnumber
Réamhshocrú1
0 – 1
Iolraitheoir a chuirtear i bhfeidhm ar mheáchan an LoRA sula gcumasaítear é sa tsamhail bhunúsach.
embeddingsroghnach
Cineálobject[]
Réamhshocrú[]
Leabaithe roghnaithe le húsáid, curtha ar fáil mar liosta.
embeddings[].pathriachtanach
Cineálstring
Meáchain leabaithe sonraithe le URL nó conair chomhaid.
embeddings[].tokensroghnach
Cineálstring[]
Liosta tócan leabaithe, le hainmniú uathoibríoch nuair a fhágtar ar lár é: faigheann gach veicteoir sa chomhad leabaithe tócan ón seicheamh <s0>, <s1>, ... .
enable_safety_checkerroghnach
Cineálboolean
Réamhshocrútrue
Gníomhachtú an tseiceálaí sábháilteachta; cumasaíonn true an tseiceáil.
safety_checker_versionroghnach
Cineálenum
Réamhshocrúv1
v1v2
Roghnaigh idir seiceálaí sábháilteachta saincheaptha ViT (`v2`) agus seiceálaí CompVis (`v1`, an réamhshocrú).
expand_promptroghnach
Cineálboolean
Réamhshocrúfalse
Leathnú na leide le leideanna breise, cumasaithe nuair atá true.
formatroghnach
Cineálenum
Réamhshocrújpeg
jpegpng
Formáid comhaid na híomhá deiridh.
request_idroghnach
Cineálstring
Réamhshocrú
Aitheantóir iarratais chun freagairt a chomhghaolú leis an iarratas a chruthaigh í.
openpose_image_urlroghnach
Cineálurl · image
URL a dhíríonn ar an íomhá rialaithe.
openpose_preprocessroghnach
Cineálboolean
Réamhshocrútrue
Rialaíonn sé réamhphróiseáil na híomhá openpose.
depth_image_urlroghnach
Cineálurl · image
URL a dhíríonn ar an íomhá rialaithe.
depth_preprocessroghnach
Cineálboolean
Réamhshocrútrue
Rialaíonn sé réamhphróiseáil na híomhá doimhneachta.
teed_image_urlroghnach
Cineálurl · image
URL a dhíríonn ar an íomhá rialaithe.
teed_preprocessroghnach
Cineálboolean
Réamhshocrútrue
Rialaíonn sé réamhphróiseáil na híomhá teed.
canny_image_urlroghnach
Cineálurl · image
URL a dhíríonn ar an íomhá rialaithe.
canny_preprocessroghnach
Cineálboolean
Réamhshocrútrue
Rialaíonn sé réamhphróiseáil na híomhá canny.
normal_image_urlroghnach
Cineálurl · image
URL a dhíríonn ar an íomhá rialaithe.
normal_preprocessroghnach
Cineálboolean
Réamhshocrútrue
Rialaíonn sé réamhphróiseáil na híomhá normálaí.
segmentation_image_urlroghnach
Cineálurl · image
URL a dhíríonn ar an íomhá rialaithe.
segmentation_preprocessroghnach
Cineálboolean
Réamhshocrútrue
Rialaíonn sé réamhphróiseáil na híomhá deighilte.
riachtanach Ainm canónach, glactar leis freisin

Glacann paraiméadair chomhaid le URL poiblí https://, URI data: suas le 10 MB, nó file_url uaslódála. Comhaid

Aschur

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"
  }
}
Do chuid comhad, do roghaIs cóip ar ár stóráil é gach outputs[].url: coinnithe go deo (íoctha in aghaidh GB-mhí) nó ar feadh 7 lá saor in aisce, de réir shocrú do chuntais nó ?storage=.
An cruth céanna ar gach samhailtype, url, content_type, width, height agus duration, d'íomhánna, d'fhíseáin agus d'fhuaim araon. Is é output réad toraidh na samhla féin.
Réimsí aschuir
images
array of object {url, width, height, content_type}Eolas comhaid do na híomhánna ginte.
timings
object
seed
integerSíol giniúint íomhá, lena n-áirítear an luach a roghnaíodh go randamach mura raibh síol san ionchur; murach sin, athúsáideann sé an luach soláthraithe.
has_nsfw_concepts
array of booleanLéiríonn sé cibé acu an bhfuil coincheapa NSFW le feiceáil sna híomhánna ginte.
prompt
stringLeid a úsáidtear le linn giniúint íomhá.

Tuilleadh samhlacha: Téacs go hÍomhá

Do ghníomhairí AI: tá an leathanach seo mar Markdown ag https://doitong.com/ga/developers/models/sdxl-controlnet-union.md. Gach samhail agus treoir: https://doitong.com/developers/llms.txt