Przejdź do treści

SDXL ControlNet Union

Integracja

Identyfikator modelu 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"

To żądanie: ≈0,014 $ 14 kredytów API · ≈ 1,48 ₽ Uruchom na tej stronie

Uzyskaj klucz API
Stability AI Tekst na obraz #diffusion#controlnet#composition

SDXL text-to-image sterowany przez maksymalnie sześć obrazów kontrolnych: openpose, mapa głębi, teed, canny, normal, segmentacja

Stability AI · Obraz

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane

Opisz obraz, który chcesz wygenerować, używając jak największej liczby szczegółów, aby uzyskać najlepsze wyniki.

image_size

Wymiary wyniku, określane automatycznie na podstawie obrazu sterującego, gdy nie podano rozmiaru.

num_images domyślnie 1

Liczba obrazów żądanych do wygenerowania.

Zaawansowane 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
domyślnie

Negatywny prompt określający szczegóły obrazu do wykluczenia, w tym kolory, obiekty, scenerię lub drobniejsze cechy. Przykłady obejmują wąsy, rozmycie lub niską rozdzielczość.

Upuść plik lub

URL wskazujący obraz sterujący.

Upuść plik lub

URL wskazujący obraz sterujący.

Upuść plik lub

URL wskazujący obraz sterujący.

Upuść plik lub

URL wskazujący obraz sterujący.

Upuść plik lub

URL wskazujący obraz sterujący.

Upuść plik lub

URL wskazujący obraz sterujący.

safety_checker_version domyślnie v1

Wybór między niestandardowym modułem sprawdzającym bezpieczeństwo ViT (`v2`) a modułem CompVis (`v1`, domyślnym).

format domyślnie jpeg

Format pliku wynikowego obrazu.

domyślnie

Identyfikator żądania służący do powiązania odpowiedzi z żądaniem, które ją wygenerowało.

domyślnie 0.5

Siła warunkowania zastosowanego przez ControlNet.

domyślnie 35

Liczba kroków inferencji do wykonania.

domyślnie 7.5

Siła zgodności z promptem przy wyborze obrazu, wyrażona jako CFG (Classifier Free Guidance).

Ziarno do odtwarzania obrazów w Stable Diffusion. Obraz można odtworzyć dokładnie przy każdym uruchomieniu, zachowując bez zmian wersję modelu, prompt i ziarno.

domyślnie []

Wagi LoRA wybrane do użycia, przekazane jako lista.

domyślnie []

Embeddingi wybrane do użycia, przekazane jako lista.

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

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o SDXL ControlNet Union

Generuje obrazy SDXL z `prompt` sterowanym przez obrazy kontrolne, takie jak openpose, mapa głębi, teed, canny, normal lub segmentacja, z osobnym przełącznikiem wstępnego przetwarzania dla każdego z nich. `controlnet_conditioning_scale` mieści się w zakresie od 0 do 1. Rozmiar obrazu może zostać wywnioskowany z obrazu kontrolnego. Obsługuje LoRA, embeddingi, od 1 do 8 obrazów oraz wynik jpeg lub png.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
promptwymagane
Typstring
Opisz obraz, który chcesz wygenerować, używając jak największej liczby szczegółów, aby uzyskać najlepsze wyniki.
controlnet_conditioning_scaleopcjonalne
Typnumber
Domyślne0.5
0 – 1
Siła warunkowania zastosowanego przez ControlNet.
negative_promptopcjonalne
Typstring
Domyślne
Negatywny prompt określający szczegóły obrazu do wykluczenia, w tym kolory, obiekty, scenerię lub drobniejsze cechy. Przykłady obejmują wąsy, rozmycie lub niską rozdzielczość.
image_sizeopcjonalne
Typobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Wymiary wyniku, określane automatycznie na podstawie obrazu sterującego, gdy nie podano rozmiaru.
num_inference_stepsopcjonalne
Typinteger
Domyślne35
1 – 70
Liczba kroków inferencji do wykonania.
seedopcjonalne
Typinteger | null
Ziarno do odtwarzania obrazów w Stable Diffusion. Obraz można odtworzyć dokładnie przy każdym uruchomieniu, zachowując bez zmian wersję modelu, prompt i ziarno.
guidance_scaleopcjonalne
Typnumber
Domyślne7.5
0 – 20
Siła zgodności z promptem przy wyborze obrazu, wyrażona jako CFG (Classifier Free Guidance).
num_imagesopcjonalne num_outputs
Typinteger
Domyślne1
1 – 8
Liczba obrazów żądanych do wygenerowania.
lorasopcjonalne
Typobject[]
Domyślne[]
Wagi LoRA wybrane do użycia, przekazane jako lista.
loras[].forceopcjonalne
Typboolean
Domyślnefalse
Czy użycie embeddingu jest obowiązkowe: true oznacza wymóg jego użycia.
loras[].pathwymagane
Typstring
Źródło wag LoRA, podane jako identyfikator modelu HF wskazujący wagi safetensors albo jako plik safetensors zlokalizowany za pomocą URL-a lub ścieżki.
loras[].scaleopcjonalne
Typnumber
Domyślne1
0 – 1
Mnożnik stosowany do wagi LoRA przed połączeniem jej z modelem bazowym.
embeddingsopcjonalne
Typobject[]
Domyślne[]
Embeddingi wybrane do użycia, przekazane jako lista.
embeddings[].pathwymagane
Typstring
Wagi embeddingu określone przez URL lub ścieżkę pliku.
embeddings[].tokensopcjonalne
Typstring[]
Lista tokenów embeddingu; gdy zostanie pominięta, dostępne jest automatyczne nazewnictwo: każdy wektor w pliku embeddingu otrzymuje token z sekwencji <s0>, <s1>, ... .
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Aktywacja kontroli bezpieczeństwa; true włącza kontrolę.
safety_checker_versionopcjonalne
Typenum
Domyślnev1
v1v2
Wybór między niestandardowym modułem sprawdzającym bezpieczeństwo ViT (`v2`) a modułem CompVis (`v1`, domyślnym).
expand_promptopcjonalne
Typboolean
Domyślnefalse
Rozszerzanie promptu o dodatkowe prompty, włączane wartością true.
formatopcjonalne
Typenum
Domyślnejpeg
jpegpng
Format pliku wynikowego obrazu.
request_idopcjonalne
Typstring
Domyślne
Identyfikator żądania służący do powiązania odpowiedzi z żądaniem, które ją wygenerowało.
openpose_image_urlopcjonalne
Typurl · image
URL wskazujący obraz sterujący.
openpose_preprocessopcjonalne
Typboolean
Domyślnetrue
Steruje wstępnym przetwarzaniem obrazu openpose.
depth_image_urlopcjonalne
Typurl · image
URL wskazujący obraz sterujący.
depth_preprocessopcjonalne
Typboolean
Domyślnetrue
Steruje wstępnym przetwarzaniem obrazu głębi.
teed_image_urlopcjonalne
Typurl · image
URL wskazujący obraz sterujący.
teed_preprocessopcjonalne
Typboolean
Domyślnetrue
Steruje wstępnym przetwarzaniem obrazu teed.
canny_image_urlopcjonalne
Typurl · image
URL wskazujący obraz sterujący.
canny_preprocessopcjonalne
Typboolean
Domyślnetrue
Steruje wstępnym przetwarzaniem obrazu canny.
normal_image_urlopcjonalne
Typurl · image
URL wskazujący obraz sterujący.
normal_preprocessopcjonalne
Typboolean
Domyślnetrue
Steruje wstępnym przetwarzaniem obrazu normal.
segmentation_image_urlopcjonalne
Typurl · image
URL wskazujący obraz sterujący.
segmentation_preprocessopcjonalne
Typboolean
Domyślnetrue
Steruje wstępnym przetwarzaniem obrazu segmentacji.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

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"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
images
array of object {url, width, height, content_type}Informacje o plikach wygenerowanych obrazów.
timings
object
seed
integerZiarno generowania obrazu, zawierające wartość wybraną losowo, jeśli dane wejściowe nie zawierały ziarna; w przeciwnym razie powtarza podaną wartość.
has_nsfw_concepts
array of booleanWskazuje, czy w wygenerowanych obrazach występują treści NSFW.
prompt
stringPrompt używany podczas generowania obrazu.

Więcej modeli: Tekst na obraz

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/sdxl-controlnet-union.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt