Přejít na obsah

ControlNet SDXL · Image to Image

Integrace

ID modelu fast-sdxl-controlnet-canny/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.com/v1/run/fast-sdxl-controlnet-canny/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",
    "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"
  }'

# 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"

Tento požadavek: ≈0,015 $ 15 kreditů API Spustit na této stránce

Získat API klíč
Stability AI Úprava obrázků Rychlé #diffusion#controlnet#editing#manipulation

ControlNet SDXL pro převod obrázku na obrázek, který mění styl zdrojového obrázku podle struktury kontrolního obrázku

Stability AI · Obrázek

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

•povinné

Popište obrázek, který chcete vygenerovat; pro nejlepší výsledky uveďte co nejvíce detailů.

•povinné
Přetáhněte soubor nebo

URL odkazující na kontrolní obrázek.

•povinné image_url
Přetáhněte soubor nebo

Počáteční obrázek pro generování zadaný pomocí URL.

image_size

Výstupní rozměry automaticky určené z kontrolního obrázku, pokud není zadána velikost.

num_images výchozí 1

Počet obrázků požadovaných ke generování.

Pokročilé negative_prompt · 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 · loras · embeddings
výchozí

Negativní prompt určující nežádoucí detaily obrázku. Může vyloučit barvy, objekty, scenérii nebo jemnější prvky a vlastnosti, například knír, rozmazání nebo nízké rozlišení.

safety_checker_version výchozí v1

Volba mezi vlastním bezpečnostním kontrolorem ViT (`v2`) a kontrolorem CompVis (`v1`, výchozí).

format výchozí jpeg

Formát souboru výsledného obrázku.

výchozí

Identifikátor požadavku pro propojení odpovědi s požadavkem, který ji vytvořil.

výchozí 0.5

Síla podmiňování aplikovaného pomocí ControlNet.

výchozí 35

Počet inferenčních kroků, které se mají provést.

výchozí 7.5

Síla dodržení promptu při výběru obrázku vyjádřená jako CFG (Classifier Free Guidance).

výchozí 0.95

Míra podobnosti mezi generovaným a počátečním obrázkem.

Seed pro reprodukci obrázků ve Stable Diffusion. Obrázek lze při každém spuštění přesně reprodukovat, pokud zůstanou beze změny verze modelu, prompt a seed.

výchozí []

Váhy LoRA vybrané k použití, zadané jako seznam.

výchozí []

Embeddingy vybrané k použití, zadané jako seznam.

POST /run/fast-sdxl-controlnet-canny/image-to-image?wait=20 cena → 0,015 $
# 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/fast-sdxl-controlnet-canny/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",
    "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"
  }'

# 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"

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu ControlNet SDXL · Image to Image

Přijímá `prompt`, `control_image_url` pro strukturu a `image_url` jako výchozí obrázek. `strength` (0.05 až 1, výchozí 0.95) určuje, jak přesně výsledek sleduje zdroj. Další možnosti zahrnují `preserve_aspect_ratio`, `crop_output`, LoRA, embeddingy a až 8 obrázků na požadavek.

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis
promptpovinné
Typstring
Popište obrázek, který chcete vygenerovat; pro nejlepší výsledky uveďte co nejvíce detailů.
control_image_urlpovinné
Typurl · image
URL odkazující na kontrolní obrázek.
controlnet_conditioning_scalevolitelné
Typnumber
Výchozí0.5
0 – 1
Síla podmiňování aplikovaného pomocí ControlNet.
image_urlpovinné image
Typurl · image
Počáteční obrázek pro generování zadaný pomocí URL.
negative_promptvolitelné
Typstring
Výchozí
Negativní prompt určující nežádoucí detaily obrázku. Může vyloučit barvy, objekty, scenérii nebo jemnější prvky a vlastnosti, například knír, rozmazání nebo nízké rozlišení.
image_sizevolitelné
Typobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Výstupní rozměry automaticky určené z kontrolního obrázku, pokud není zadána velikost.
num_inference_stepsvolitelné
Typinteger
Výchozí35
1 – 70
Počet inferenčních kroků, které se mají provést.
guidance_scalevolitelné
Typnumber
Výchozí7.5
0 – 20
Síla dodržení promptu při výběru obrázku vyjádřená jako CFG (Classifier Free Guidance).
strengthvolitelné
Typnumber
Výchozí0.95
0,05 – 1
Míra podobnosti mezi generovaným a počátečním obrázkem.
seedvolitelné
Typinteger | null
Seed pro reprodukci obrázků ve Stable Diffusion. Obrázek lze při každém spuštění přesně reprodukovat, pokud zůstanou beze změny verze modelu, prompt a seed.
num_imagesvolitelné num_outputs
Typinteger
Výchozí1
1 – 8
Počet obrázků požadovaných ke generování.
lorasvolitelné
Typobject[]
Výchozí[]
Váhy LoRA vybrané k použití, zadané jako seznam.
loras[].forcevolitelné
Typboolean
Výchozífalse
Zda je použití embeddingu povinné: true jej vynutí.
loras[].pathpovinné
Typstring
Zdroj vah LoRA zadaný jako identifikátor modelu HF odkazující na váhy safetensors nebo jako soubor safetensors dostupný přes URL či cestu.
loras[].scalevolitelné
Typnumber
Výchozí1
0 – 1
Násobitel použitý pro váhu LoRA před jejím sloučením se základním modelem.
embeddingsvolitelné
Typobject[]
Výchozí[]
Embeddingy vybrané k použití, zadané jako seznam.
embeddings[].pathpovinné
Typstring
Váhy embeddingu určené URL nebo cestou k souboru.
embeddings[].tokensvolitelné
Typstring[]
Seznam tokenů embeddingu s automatickým pojmenováním při vynechání: každý vektor v souboru embeddingu obdrží token z posloupnosti <s0>, <s1>, ... .
enable_safety_checkervolitelné
Typboolean
Výchozítrue
Aktivace bezpečnostní kontroly; true kontrolu povolí.
safety_checker_versionvolitelné
Typenum
Výchozív1
v1v2
Volba mezi vlastním bezpečnostním kontrolorem ViT (`v2`) a kontrolorem CompVis (`v1`, výchozí).
expand_promptvolitelné
Typboolean
Výchozífalse
Rozšíření promptu o další prompty, aktivované při hodnotě true.
formatvolitelné
Typenum
Výchozíjpeg
jpegpng
Formát souboru výsledného obrázku.
request_idvolitelné
Typstring
Výchozí
Identifikátor požadavku pro propojení odpovědi s požadavkem, který ji vytvořil.
preserve_aspect_ratiovolitelné
Typboolean
Výchozífalse
Nastavením na true zachováte poměr stran generovaného obrázku, i když jeho velikost překročí limit. Chcete-li po generování ořezáním získat správné proporce, nastavte crop_output na True. Hodnoty šířky nebo výšky nedělitelné 32 se stále zaokrouhlují na nejbližší násobek 32 a toto změnění velikosti ve výchozím nastavení poměr stran nezachovává.
crop_outputvolitelné
Typboolean
Výchozífalse
Při hodnotě true ořízne generovaný výstup na správný poměr stran.
povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "fast-sdxl-controlnet-canny/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": 15,
    "usd": "0.015",
    "charged": 15,
    "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",
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vaše soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
images
array of object {url, width, height, content_type}Informace o souborech vygenerovaných obrázků.
timings
object
seed
integerSeed pro generování obrázku včetně náhodně zvolené hodnoty, pokud vstup seed neobsahoval; jinak opakuje zadanou hodnotu.
has_nsfw_concepts
array of booleanUrčuje, zda se v generovaných obrázcích objevují koncepty NSFW.
prompt
stringPrompt použitý při generování obrázku.

Další modely: Úprava obrázků

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/fast-sdxl-controlnet-canny/image-to-image.md. Všechny modely a návody: https://doitong.com/developers/llms.txt