Naar inhoud springen

ControlNet SDXL · Inpainting

Integreren

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

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

API-sleutel ophalen
Stability AI Afbeelding bewerken Snel #diffusion#controlnet#editing#manipulation

ControlNet SDXL inpainting: schildert een gemaskeerd gebied opnieuw onder begeleiding van een controleafbeelding

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.

•verplicht
Sleep een bestand hierheen of

URL naar de controleafbeelding.

•verplicht image_url
Sleep een bestand hierheen of

Startafbeelding voor generatie, aangeleverd via URL.

•verplicht mask_url
Sleep een bestand hierheen of

URL naar het inpaintingmasker.

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

Negatieve prompt met ongewenste afbeeldingsdetails. Hiermee kunnen kleuren, objecten, landschappen of fijnere kenmerken en kwaliteiten, zoals een snor, vervaging of lage resolutie, worden uitgesloten.

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

standaard 0.95

Mate van gelijkenis tussen de gegenereerde afbeelding en de oorspronkelijke afbeelding.

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/fast-sdxl-controlnet-canny/inpainting?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.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"

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

Vereist een `prompt`, `control_image_url`, `image_url` en een `mask_url` die het opnieuw te schilderen gebied markeert. `strength` varieert van 0.01 tot 1 (standaard 0.95) en `controlnet_conditioning_scale` van 0 tot 1. Maximaal 8 uitvoerafbeeldingen en 70 stappen, met ondersteuning voor LoRA en embeddings.

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.
control_image_urlverplicht
Typeurl · image
URL naar de controleafbeelding.
controlnet_conditioning_scaleoptioneel
Typenumber
Standaard0.5
0 – 1
Sterkte van de conditionering die door ControlNet wordt toegepast.
image_urlverplicht image
Typeurl · image
Startafbeelding voor generatie, aangeleverd via URL.
mask_urlverplicht mask
Typeurl · image
URL naar het inpaintingmasker.
negative_promptoptioneel
Typestring
Standaard
Negatieve prompt met ongewenste afbeeldingsdetails. Hiermee kunnen kleuren, objecten, landschappen of fijnere kenmerken en kwaliteiten, zoals een snor, vervaging of lage resolutie, worden uitgesloten.
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.
guidance_scaleoptioneel
Typenumber
Standaard7.5
0 – 20
Sterkte waarmee de prompt wordt gevolgd bij beeldselectie, uitgedrukt als CFG (Classifier Free Guidance).
strengthoptioneel
Typenumber
Standaard0.95
0,01 – 1
Mate van gelijkenis tussen de gegenereerde afbeelding en de oorspronkelijke afbeelding.
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.
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.
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": "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"
  }
}
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: Afbeelding bewerken

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