Léim chuig an ábhar

SDXL ControlNet Union · Image to Image

Comhtháthú

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

An t-iarratas seo: ≈$0.048 48 gcreidmheas API · ≈ ₽5.16 Rith ar an leathanach seo

Faigh eochair API
Stability AI Eagarthóireacht Íomhá #diffusion#controlnet#composition

SDXL íomhá-go-íomhá le treoir il-ControlNet ó íomhánna rialaithe staide, doimhneachta, ciumhaise, gnáthóige nó deighilte

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.

•riachtanach image_url
Scaoil comhad, nó

Íomhá tosaigh don ghiniúint, a sholáthraítear trí URL.

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

Leid dhiúltach ina sonraítear sonraí íomhá nach dteastaíonn. Is féidir dathanna, réada, radhairc nó gnéithe agus cáilíochtaí míne amhail mustache, doiléireacht nó taifeach íseal a eisiamh.

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

réamhshocrú 0.95

Leibhéal cosúlachta idir an íomhá ghinte agus an íomhá tosaigh.

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/image-to-image?wait=20 luachan → $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"

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 · Image to Image

Athraíonn sé íomhá thosaigh ag úsáid bonn SDXL faoi threoir leid agus íomhánna rialaithe roghnacha do openpose, mapa doimhneachta, teed, canny, normal agus deighilt. Tá scorán réamhphróiseála dá chuid féin ag gach ionchur rialaithe. Raonta `strength` ó 0.05 go 1, `num_inference_steps` ó 1 go 70, agus is féidir suas le 8 n-íomhá a thabhairt ar ais in aghaidh an ghlao. Is féidir LoRAs agus leabuithe a sholáthar, agus is jpeg nó png an t-aschur.

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.
image_urlriachtanach image
Cineálurl · image
Íomhá tosaigh don ghiniúint, a sholáthraítear trí URL.
negative_promptroghnach
Cineálstring
Réamhshocrú
Leid dhiúltach ina sonraítear sonraí íomhá nach dteastaíonn. Is féidir dathanna, réada, radhairc nó gnéithe agus cáilíochtaí míne amhail mustache, doiléireacht nó taifeach íseal a eisiamh.
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.
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).
strengthroghnach
Cineálnumber
Réamhshocrú0.95
0.05 – 1
Leibhéal cosúlachta idir an íomhá ghinte agus an íomhá tosaigh.
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ú.
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 í.
preserve_aspect_ratioroghnach
Cineálboolean
Réamhshocrúfalse
Socraigh go true chun cóimheas gné na híomhá ghinte a choinneáil fiú má sháraíonn a méid an teorainn. Chun na comhréireanna cearta a fháil trí bhearradh tar éis na giniúna, socraigh crop_output go True. Déantar luachanna leithead nó airde nach bhfuil inroinnte ar 32 a shlánú go dtí an t-iolraí is gaire de 32, agus ní choinníonn an t-athrú méide seo an cóimheas gné de réir réamhshocraithe.
crop_outputroghnach
Cineálboolean
Réamhshocrúfalse
Bearr an t-aschur ginte go dtí an cóimheas gné ceart nuair atá true.
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/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"
  }
}
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: Eagarthóireacht Íomhá

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