Przejdź do treści

ControlNet SDXL · Inpainting

Integracja

Identyfikator modelu fast-sdxl-controlnet-canny/inpainting
# 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/fast-sdxl-controlnet-canny/inpainting?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",
    "control_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "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"

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

Uzyskaj klucz API
Stability AI Edycja obrazów Szybki #diffusion#controlnet#editing#manipulation

Wypełnianie ControlNet SDXL: ponowne malowanie zamaskowanego obszaru obrazu pod kontrolą obrazu sterującego

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.

•wymagane
Upuść plik lub

URL wskazujący obraz sterujący.

•wymagane image_url
Upuść plik lub

Obraz początkowy do generowania, dostarczony przez URL.

•wymagane mask_url
Upuść plik lub

URL wskazujący maskę malowania.

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 · safety_checker_version · format · request_id · controlnet_conditioning_scale · num_inference_steps · guidance_scale · strength · seed · enable_safety_checker · expand_prompt · loras · embeddings
domyślnie

Negatywny prompt określający niepożądane szczegóły obrazu. Może wykluczać kolory, obiekty, scenerię lub drobniejsze cechy i właściwości, takie jak wąsy, rozmycie lub niska rozdzielczość.

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

domyślnie 0.95

Stopień podobieństwa między wygenerowanym obrazem a obrazem początkowym.

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/fast-sdxl-controlnet-canny/inpainting?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/fast-sdxl-controlnet-canny/inpainting?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",
    "control_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "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"

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 ControlNet SDXL · Inpainting

Wymaga `prompt`, `control_image_url`, `image_url` i `mask_url` wskazującego obszar do odtworzenia. `strength` przyjmuje wartości od 0.01 do 1 (domyślnie 0.95), a `controlnet_conditioning_scale` od 0 do 1. Zwraca maksymalnie 8 wyników i obsługuje 70 kroków, LoRA oraz embeddingi.

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.
control_image_urlwymagane
Typurl · image
URL wskazujący obraz sterujący.
controlnet_conditioning_scaleopcjonalne
Typnumber
Domyślne0.5
0 – 1
Siła warunkowania zastosowanego przez ControlNet.
image_urlwymagane image
Typurl · image
Obraz początkowy do generowania, dostarczony przez URL.
mask_urlwymagane mask
Typurl · image
URL wskazujący maskę malowania.
negative_promptopcjonalne
Typstring
Domyślne
Negatywny prompt określający niepożądane szczegóły obrazu. Może wykluczać kolory, obiekty, scenerię lub drobniejsze cechy i właściwości, takie jak wąsy, rozmycie lub niska 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.
guidance_scaleopcjonalne
Typnumber
Domyślne7.5
0 – 20
Siła zgodności z promptem przy wyborze obrazu, wyrażona jako CFG (Classifier Free Guidance).
strengthopcjonalne
Typnumber
Domyślne0.95
0,01 – 1
Stopień podobieństwa między wygenerowanym obrazem a obrazem początkowym.
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.
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.
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": "fast-sdxl-controlnet-canny/inpainting",
  "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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_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",
    "control_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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: Edycja obrazów

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