Sleppa yfir í efni

SDXL ControlNet Union

Tengja

Auðkenni líkans 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Þessi beiðni: ≈0,014 $ 14 API-inneignir Keyra á þessari síðu

Fá API-lykil
Stability AI Texti í mynd #diffusion#controlnet#composition

SDXL texti í mynd undir leiðsögn allt að sex stýrimynda: openpose, dýptarkort, teed, canny, normal, hlutun

Stability AI · Mynd

Fyrsta niðurstaðan þín birtist hér

Búðu til beiðni hér að neðan og keyrðu hana með API-lyklinum þínum. Úttök eru afrituð í geymsluna okkar og geymd að eilífu eða 7 dagar án kostnaðar.

Búa til beiðni

Stýringar eru búnar til út frá líkanaskemanu. Kóðinn og verðið uppfærast þegar þú breytir þeim.

•áskilið

Lýstu myndinni sem þú vilt láta búa til eins ítarlega og mögulegt er til að ná sem bestum niðurstöðum.

image_size

Mál úttaks, ákvörðuð sjálfkrafa út frá stýringarmyndinni þegar stærð er ekki gefin upp.

num_images sjálfgefið 1

Fjöldi mynda sem óskað er eftir í efnisgerð.

Ítarlegt 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
sjálfgefið

Neikvæð kvaðning sem tilgreinir smáatriði myndar sem á að útiloka, þar á meðal liti, hluti, landslag eða fínni einkenni. Dæmi eru yfirvaraskegg, óskýring eða lág upplausn.

Slepptu skrá eða

URL sem vísar á stýringarmyndina.

Slepptu skrá eða

URL sem vísar á stýringarmyndina.

Slepptu skrá eða

URL sem vísar á stýringarmyndina.

Slepptu skrá eða

URL sem vísar á stýringarmyndina.

Slepptu skrá eða

URL sem vísar á stýringarmyndina.

Slepptu skrá eða

URL sem vísar á stýringarmyndina.

safety_checker_version sjálfgefið v1

Veldu á milli sérsniðins ViT-öryggiseftirlits (`v2`) og CompVis-eftirlitsins (`v1`, sjálfgefið).

format sjálfgefið jpeg

Skráarsnið myndarinnar sem verður til.

sjálfgefið

Auðkenni beiðni til að tengja svar við beiðnina sem bjó það til.

sjálfgefið 0.5

Styrkur skilyrðingar sem ControlNet beitir.

sjálfgefið 35

Fjöldi ályktunarskrefa sem á að keyra.

sjálfgefið 7.5

Styrkur fylgni við kvaðningu fyrir val á mynd, gefinn upp sem CFG (Classifier Free Guidance).

Sáð til að endurgera myndir í Stable Diffusion. Hægt er að endurgera mynd nákvæmlega í hverri keyrslu með því að halda útgáfu líkans, kvaðningu og sáði óbreyttum.

sjálfgefið []

LoRA-vigtir valdar til notkunar, gefnar sem listi.

sjálfgefið []

Innfellingar valdar til notkunar, gefnar sem listi.

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

Keyra þessa beiðni

Lykillinn þinn er áfram í þessum vafra: hann er aðeins sendur til Doitong API og vistaður í localStorage aðeins ef þú hakar við Muna. Fá API-lykil

Um SDXL ControlNet Union

Myndgerir SDXL-myndir úr `prompt` undir leiðsögn stýrimynda á borð við openpose, dýptarkort, teed, canny, normal eða hlutun, hver með eigin forvinnslurofa. `controlnet_conditioning_scale` er frá 0 til 1. Myndstærð getur verið leidd af stýrimyndinni. Styður LoRA, innfellingar, 1 til 8 myndir og jpeg- eða png-úttak.

Færibreytur

Sendu annaðhvort samræmda heitið eða upprunalega heitið, ekki bæði. Samræmd heiti

HeitiGerð SjálfgefiðLeyfilegt Lýsing
promptáskilið
Gerðstring
Lýstu myndinni sem þú vilt láta búa til eins ítarlega og mögulegt er til að ná sem bestum niðurstöðum.
controlnet_conditioning_scalevalfrjálst
Gerðnumber
Sjálfgefið0.5
0 – 1
Styrkur skilyrðingar sem ControlNet beitir.
negative_promptvalfrjálst
Gerðstring
Sjálfgefið
Neikvæð kvaðning sem tilgreinir smáatriði myndar sem á að útiloka, þar á meðal liti, hluti, landslag eða fínni einkenni. Dæmi eru yfirvaraskegg, óskýring eða lág upplausn.
image_sizevalfrjálst
Gerðobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Mál úttaks, ákvörðuð sjálfkrafa út frá stýringarmyndinni þegar stærð er ekki gefin upp.
num_inference_stepsvalfrjálst
Gerðinteger
Sjálfgefið35
1 – 70
Fjöldi ályktunarskrefa sem á að keyra.
seedvalfrjálst
Gerðinteger | null
Sáð til að endurgera myndir í Stable Diffusion. Hægt er að endurgera mynd nákvæmlega í hverri keyrslu með því að halda útgáfu líkans, kvaðningu og sáði óbreyttum.
guidance_scalevalfrjálst
Gerðnumber
Sjálfgefið7.5
0 – 20
Styrkur fylgni við kvaðningu fyrir val á mynd, gefinn upp sem CFG (Classifier Free Guidance).
num_imagesvalfrjálst num_outputs
Gerðinteger
Sjálfgefið1
1 – 8
Fjöldi mynda sem óskað er eftir í efnisgerð.
lorasvalfrjálst
Gerðobject[]
Sjálfgefið[]
LoRA-vigtir valdar til notkunar, gefnar sem listi.
loras[].forcevalfrjálst
Gerðboolean
Sjálfgefiðfalse
Hvort notkun innfellingar sé skylda: true gerir hana nauðsynlega.
loras[].patháskilið
Gerðstring
Uppruni LoRA-vigta, gefinn sem HF-líkaniðkendi sem leysist í safetensors-vigtir eða sem safetensors-skrá sem finnst með vefslóð eða slóð.
loras[].scalevalfrjálst
Gerðnumber
Sjálfgefið1
0 – 1
Margfeldisstuðull sem beitt er á LoRA-vigtina áður en henni er sameinað grunnlíkaninu.
embeddingsvalfrjálst
Gerðobject[]
Sjálfgefið[]
Innfellingar valdar til notkunar, gefnar sem listi.
embeddings[].patháskilið
Gerðstring
Innfellingarvigtir tilgreindar með vefslóð eða skráarslóð.
embeddings[].tokensvalfrjálst
Gerðstring[]
Listi yfir innfellingartákn; þegar hann er ekki gefinn eru nöfn búin til sjálfkrafa: hver vigur í innfellingarskránni fær tákn úr röðinni <s0>, <s1>, ... .
enable_safety_checkervalfrjálst
Gerðboolean
Sjálfgefiðtrue
Virkjun öryggisathugunar; true virkjar athugun.
safety_checker_versionvalfrjálst
Gerðenum
Sjálfgefiðv1
v1v2
Veldu á milli sérsniðins ViT-öryggiseftirlits (`v2`) og CompVis-eftirlitsins (`v1`, sjálfgefið).
expand_promptvalfrjálst
Gerðboolean
Sjálfgefiðfalse
Útvíkkun kvaðningar með viðbótarkvaðningum, virk þegar true.
formatvalfrjálst
Gerðenum
Sjálfgefiðjpeg
jpegpng
Skráarsnið myndarinnar sem verður til.
request_idvalfrjálst
Gerðstring
Sjálfgefið
Auðkenni beiðni til að tengja svar við beiðnina sem bjó það til.
openpose_image_urlvalfrjálst
Gerðurl · image
URL sem vísar á stýringarmyndina.
openpose_preprocessvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Stýrir forvinnslu openpose-myndar.
depth_image_urlvalfrjálst
Gerðurl · image
URL sem vísar á stýringarmyndina.
depth_preprocessvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Stýrir forvinnslu dýptarmyndar.
teed_image_urlvalfrjálst
Gerðurl · image
URL sem vísar á stýringarmyndina.
teed_preprocessvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Stýrir forvinnslu teed-myndar.
canny_image_urlvalfrjálst
Gerðurl · image
URL sem vísar á stýringarmyndina.
canny_preprocessvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Stýrir forvinnslu canny-myndar.
normal_image_urlvalfrjálst
Gerðurl · image
URL sem vísar á stýringarmyndina.
normal_preprocessvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Stýrir forvinnslu normal-myndar.
segmentation_image_urlvalfrjálst
Gerðurl · image
URL sem vísar á stýringarmyndina.
segmentation_preprocessvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Stýrir forvinnslu hlutgreiningarmyndar.
áskilið Samræmt heiti, einnig samþykkt

Skrárfæribreytur taka við opinberri https://-vefslóð, data:-URI allt að 10 MB eða file_url fyrir upphleðslu. Skrár

Úttak

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Skrárnar þínar, þitt valHvert outputs[].url er afrit í geymslunni okkar: geymt að eilífu (greitt fyrir hvert GB-mánuðargildi) eða 7 dagar án kostnaðar, eftir stillingu aðgangsins þíns eða ?storage=.
Sama lögun í öllum líkönumtype, url, content_type, width, height og duration, jafnt fyrir myndir, myndbönd og hljóð. output er eigið niðurstöðuhlutur líkansins.
Reitir úttaks
images
array of object {url, width, height, content_type}Skráarupplýsingar fyrir myndirnar sem verða til.
timings
object
seed
integerSáðgildi fyrir myndgerð, þar með talið slembivalið gildi ef inntakið innihélt ekkert sáðgildi; annars endurtekur það gefna gildið.
has_nsfw_concepts
array of booleanGefur til kynna hvort NSFW-hugtök komi fyrir í myndunum sem verða til.
prompt
stringKvaðning notuð við myndgerð.

Fleiri líkön: Texti í mynd

Fyrir gervigreindarþjóna: þessi síða á Markdown-sniði er á https://doitong.com/is/developers/models/sdxl-controlnet-union.md. Öll líkön og leiðbeiningar: https://doitong.com/developers/llms.txt