Naar inhoud springen

SDXL ControlNet Union

Integreren

Model-ID 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"

Deze request: ≈$ 0,014 14 API-tegoed Op deze pagina uitvoeren

API-sleutel ophalen
Stability AI Tekst naar afbeelding #diffusion#controlnet#composition

SDXL tekst-naar-afbeelding, aangestuurd door maximaal zes controleafbeeldingen: openpose, dieptekaart, teed, canny, normal, segmentatie

Stability AI · Afbeelding

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht

Beschrijf de afbeelding die je wilt laten genereren zo gedetailleerd mogelijk voor de beste resultaten.

image_size

Uitvoerafmetingen, automatisch bepaald aan de hand van de controleafbeelding wanneer geen grootte wordt opgegeven.

num_images standaard 1

Aantal afbeeldingen dat voor generatie wordt aangevraagd.

Geavanceerd 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
standaard

Negatieve prompt met afbeeldingsdetails die moeten worden weggelaten, waaronder kleuren, objecten, landschappen of fijnere kenmerken. Voorbeelden zijn een snor, vervaging of lage resolutie.

Sleep een bestand hierheen of

URL naar de controleafbeelding.

Sleep een bestand hierheen of

URL naar de controleafbeelding.

Sleep een bestand hierheen of

URL naar de controleafbeelding.

Sleep een bestand hierheen of

URL naar de controleafbeelding.

Sleep een bestand hierheen of

URL naar de controleafbeelding.

Sleep een bestand hierheen of

URL naar de controleafbeelding.

safety_checker_version standaard v1

Kies tussen een aangepaste ViT-veiligheidscontrole (`v2`) en de CompVis-controle (`v1`, de standaard).

format standaard jpeg

Bestandsindeling van de resulterende afbeelding.

standaard

Request-ID om een response te correleren met de request die deze heeft geproduceerd.

standaard 0.5

Sterkte van de conditionering die door ControlNet wordt toegepast.

standaard 35

Aantal uit te voeren inferentiestappen.

standaard 7.5

Sterkte waarmee de prompt wordt gevolgd bij beeldselectie, uitgedrukt als CFG (Classifier Free Guidance).

Seed voor het reproduceren van afbeeldingen in Stable Diffusion. Een afbeelding kan bij elke run exact worden gereproduceerd door de modelversie, prompt en seed ongewijzigd te laten.

standaard []

LoRA-gewichten die voor gebruik zijn geselecteerd, verstrekt als lijst.

standaard []

Embeddings die voor gebruik zijn geselecteerd, verstrekt als lijst.

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

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over SDXL ControlNet Union

Genereert SDXL-afbeeldingen op basis van een `prompt`, aangestuurd door controleafbeeldingen zoals openpose, dieptekaart, teed, canny, normal of segmentatie, elk met een eigen preprocess-schakelaar. `controlnet_conditioning_scale` loopt van 0 tot 1. De afbeeldingsgrootte kan uit de controleafbeelding worden afgeleid. Ondersteunt LoRAs, embeddings, 1 tot 8 afbeeldingen en jpeg- of png-uitvoer.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
promptverplicht
Typestring
Beschrijf de afbeelding die je wilt laten genereren zo gedetailleerd mogelijk voor de beste resultaten.
controlnet_conditioning_scaleoptioneel
Typenumber
Standaard0.5
0 – 1
Sterkte van de conditionering die door ControlNet wordt toegepast.
negative_promptoptioneel
Typestring
Standaard
Negatieve prompt met afbeeldingsdetails die moeten worden weggelaten, waaronder kleuren, objecten, landschappen of fijnere kenmerken. Voorbeelden zijn een snor, vervaging of lage resolutie.
image_sizeoptioneel
Typeobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Uitvoerafmetingen, automatisch bepaald aan de hand van de controleafbeelding wanneer geen grootte wordt opgegeven.
num_inference_stepsoptioneel
Typeinteger
Standaard35
1 – 70
Aantal uit te voeren inferentiestappen.
seedoptioneel
Typeinteger | null
Seed voor het reproduceren van afbeeldingen in Stable Diffusion. Een afbeelding kan bij elke run exact worden gereproduceerd door de modelversie, prompt en seed ongewijzigd te laten.
guidance_scaleoptioneel
Typenumber
Standaard7.5
0 – 20
Sterkte waarmee de prompt wordt gevolgd bij beeldselectie, uitgedrukt als CFG (Classifier Free Guidance).
num_imagesoptioneel num_outputs
Typeinteger
Standaard1
1 – 8
Aantal afbeeldingen dat voor generatie wordt aangevraagd.
lorasoptioneel
Typeobject[]
Standaard[]
LoRA-gewichten die voor gebruik zijn geselecteerd, verstrekt als lijst.
loras[].forceoptioneel
Typeboolean
Standaardfalse
Of het gebruik van embeddings verplicht is: true maakt dit verplicht.
loras[].pathverplicht
Typestring
Bron van de LoRA-gewichten, aangeleverd als HF-modelidentifier die verwijst naar safetensors-gewichten, of als een safetensors-bestand dat via URL of pad wordt gevonden.
loras[].scaleoptioneel
Typenumber
Standaard1
0 – 1
Vermenigvuldiger die vóór samenvoeging met het basismodel op het LoRA-gewicht wordt toegepast.
embeddingsoptioneel
Typeobject[]
Standaard[]
Embeddings die voor gebruik zijn geselecteerd, verstrekt als lijst.
embeddings[].pathverplicht
Typestring
Embedding-gewichten die via URL of bestandspad zijn opgegeven.
embeddings[].tokensoptioneel
Typestring[]
Lijst met embedding-tokens, met automatische naamgeving wanneer deze wordt weggelaten: elke vector in het embeddingbestand krijgt een token uit de reeks <s0>, <s1>, ... .
enable_safety_checkeroptioneel
Typeboolean
Standaardtrue
Activering van de veiligheidscontrole; true schakelt controle in.
safety_checker_versionoptioneel
Typeenum
Standaardv1
v1v2
Kies tussen een aangepaste ViT-veiligheidscontrole (`v2`) en de CompVis-controle (`v1`, de standaard).
expand_promptoptioneel
Typeboolean
Standaardfalse
Promptuitbreiding met extra prompts, ingeschakeld wanneer true.
formatoptioneel
Typeenum
Standaardjpeg
jpegpng
Bestandsindeling van de resulterende afbeelding.
request_idoptioneel
Typestring
Standaard
Request-ID om een response te correleren met de request die deze heeft geproduceerd.
openpose_image_urloptioneel
Typeurl · image
URL naar de controleafbeelding.
openpose_preprocessoptioneel
Typeboolean
Standaardtrue
Regelt de voorbewerking van de openpose-afbeelding.
depth_image_urloptioneel
Typeurl · image
URL naar de controleafbeelding.
depth_preprocessoptioneel
Typeboolean
Standaardtrue
Regelt de voorbewerking van de diepteafbeelding.
teed_image_urloptioneel
Typeurl · image
URL naar de controleafbeelding.
teed_preprocessoptioneel
Typeboolean
Standaardtrue
Regelt de voorbewerking van de teed-afbeelding.
canny_image_urloptioneel
Typeurl · image
URL naar de controleafbeelding.
canny_preprocessoptioneel
Typeboolean
Standaardtrue
Regelt de voorbewerking van de canny-afbeelding.
normal_image_urloptioneel
Typeurl · image
URL naar de controleafbeelding.
normal_preprocessoptioneel
Typeboolean
Standaardtrue
Regelt de voorbewerking van de normal-afbeelding.
segmentation_image_urloptioneel
Typeurl · image
URL naar de controleafbeelding.
segmentation_preprocessoptioneel
Typeboolean
Standaardtrue
Regelt de voorbewerking van de segmentatieafbeelding.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
images
array of object {url, width, height, content_type}Bestandsinformatie voor de gegenereerde afbeeldingen.
timings
object
seed
integerSeed voor afbeeldingsgeneratie, inclusief de willekeurig gekozen waarde als de invoer geen seed bevatte; anders wordt de opgegeven waarde herhaald.
has_nsfw_concepts
array of booleanGeeft aan of NSFW-concepten in de gegenereerde afbeeldingen voorkomen.
prompt
stringPrompt die tijdens afbeeldingsgeneratie wordt gebruikt.

Meer modellen: Tekst naar afbeelding

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/sdxl-controlnet-union.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt