Gå til indhold

SDXL ControlNet Union · Inpainting

Integrer

Model-id sdxl-controlnet-union/inpainting
# 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/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",
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Denne anmodning: ≈0,012 $ 12 API-kreditter Kør den på denne side

Hent API-nøgle
Stability AI Billedredigering #diffusion#controlnet#composition

SDXL-inpainting, der udfylder et maskeret område, mens den følger positur-, dybde-, kant- eller andre ControlNet-styringer

Stability AI · Billede

Dit første resultat kommer her

Opret en anmodning nedenfor, og kør den med din API-nøgle. Output kopieres til vores lagring, gemt for altid eller 7 dage gratis.

Opret en anmodning

Kontrollerne genereres fra modellens skema. Koden og prisen opdateres, når du ændrer dem.

•påkrævet

Beskriv det billede, du vil have genereret, med så mange detaljer som muligt for at opnå de bedste resultater.

•påkrævet image_url
Slip en fil, eller

Startbillede til generering, leveret via URL.

•påkrævet mask_url
Slip en fil, eller

URL til inpainting-masken.

image_size

Outputdimensioner, der automatisk bestemmes ud fra kontrolbilledet, når ingen størrelse angives.

num_images standard 1

Antal billeder, der ønskes genereret.

Avanceret 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 · strength · seed · enable_safety_checker · expand_prompt · openpose_preprocess · depth_preprocess · teed_preprocess · canny_preprocess · normal_preprocess · segmentation_preprocess · loras · embeddings
standard

Negativ prompt, der angiver uønskede billeddetaljer. Den kan udelukke farver, objekter, sceneri eller finere træk og egenskaber såsom overskæg, sløring eller lav opløsning.

Slip en fil, eller

URL til kontrolbilledet.

Slip en fil, eller

URL til kontrolbilledet.

Slip en fil, eller

URL til kontrolbilledet.

Slip en fil, eller

URL til kontrolbilledet.

Slip en fil, eller

URL til kontrolbilledet.

Slip en fil, eller

URL til kontrolbilledet.

safety_checker_version standard v1

Vælg mellem en brugerdefineret ViT-sikkerhedskontrol (`v2`) og CompVis-kontrollen (`v1`, standarden).

format standard jpeg

Filformat for det resulterende billede.

standard

Identifikator for anmodningen til at knytte et svar til den anmodning, der frembragte det.

standard 0.5

Styrken af den conditioning, der anvendes af ControlNet.

standard 35

Antal inferenstrin, der skal køres.

standard 7.5

Styrke for prompt-overensstemmelse ved billedvalg, udtrykt som CFG (Classifier Free Guidance).

standard 0.95

Graden af lighed mellem det genererede billede og det oprindelige billede.

Seed til genskabelse af billeder i Stable Diffusion. Et billede kan genskabes nøjagtigt ved hver kørsel ved at holde modelversion, prompt og seed uændrede.

standard []

LoRA-vægte valgt til brug, leveret som en liste.

standard []

Embeddings valgt til brug, leveret som en liste.

POST /run/sdxl-controlnet-union/inpainting?wait=20 pris → 0,012 $
# 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/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",
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Kør denne anmodning

Din nøgle forbliver i denne browser: Den sendes kun til Doitong API og gemmes kun i localStorage, hvis du markerer Husk. Hent en API-nøgle

Om SDXL ControlNet Union · Inpainting

Maler kun det område, der er markeret af `mask_url`, på kilde-`image_url` ud fra en prompt. Valgfri kontrolbilleder (openpose, dybdekort, teed, canny, normal, segmentering) styrer resultatet, hver med sin egen forbehandlingskontakt. `strength` accepterer 0.01 til 1, trin går op til 70, og op til 8 billeder kan returneres pr. anmodning. LoRA'er, embeddings samt jpeg- eller png-output understøttes.

Parametre

Send enten det kanoniske navn eller det oprindelige navn, ikke begge. Kanoniske navne

NavnType StandardTilladt Beskrivelse
promptpåkrævet
Typestring
Beskriv det billede, du vil have genereret, med så mange detaljer som muligt for at opnå de bedste resultater.
controlnet_conditioning_scalevalgfri
Typenumber
Standard0.5
0 – 1
Styrken af den conditioning, der anvendes af ControlNet.
image_urlpåkrævet image
Typeurl · image
Startbillede til generering, leveret via URL.
mask_urlpåkrævet mask
Typeurl · image
URL til inpainting-masken.
negative_promptvalgfri
Typestring
Standard
Negativ prompt, der angiver uønskede billeddetaljer. Den kan udelukke farver, objekter, sceneri eller finere træk og egenskaber såsom overskæg, sløring eller lav opløsning.
image_sizevalgfri
Typeobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Outputdimensioner, der automatisk bestemmes ud fra kontrolbilledet, når ingen størrelse angives.
num_inference_stepsvalgfri
Typeinteger
Standard35
1 – 70
Antal inferenstrin, der skal køres.
guidance_scalevalgfri
Typenumber
Standard7.5
0 – 20
Styrke for prompt-overensstemmelse ved billedvalg, udtrykt som CFG (Classifier Free Guidance).
strengthvalgfri
Typenumber
Standard0.95
0,01 – 1
Graden af lighed mellem det genererede billede og det oprindelige billede.
seedvalgfri
Typeinteger | null
Seed til genskabelse af billeder i Stable Diffusion. Et billede kan genskabes nøjagtigt ved hver kørsel ved at holde modelversion, prompt og seed uændrede.
num_imagesvalgfri num_outputs
Typeinteger
Standard1
1 – 8
Antal billeder, der ønskes genereret.
lorasvalgfri
Typeobject[]
Standard[]
LoRA-vægte valgt til brug, leveret som en liste.
loras[].forcevalgfri
Typeboolean
Standardfalse
Om brug af embedding er obligatorisk: true gør det påkrævet.
loras[].pathpåkrævet
Typestring
Kilde til LoRA-vægte, angivet som en HF-modelidentifikator, der opløses til safetensors-vægte, eller som en safetensors-fil fundet via URL eller sti.
loras[].scalevalgfri
Typenumber
Standard1
0 – 1
Multiplikator anvendt på LoRA-vægten, før den flettes ind i basismodellen.
embeddingsvalgfri
Typeobject[]
Standard[]
Embeddings valgt til brug, leveret som en liste.
embeddings[].pathpåkrævet
Typestring
Embedding-vægte angivet via URL eller filsti.
embeddings[].tokensvalgfri
Typestring[]
Liste over embedding-tokens med automatisk navngivning, når den udelades: hver vektor i embedding-filen får et token fra sekvensen <s0>, <s1>, ... .
enable_safety_checkervalgfri
Typeboolean
Standardtrue
Aktivering af sikkerhedskontrol; true aktiverer kontrollen.
safety_checker_versionvalgfri
Typeenum
Standardv1
v1v2
Vælg mellem en brugerdefineret ViT-sikkerhedskontrol (`v2`) og CompVis-kontrollen (`v1`, standarden).
expand_promptvalgfri
Typeboolean
Standardfalse
Promptudvidelse med yderligere prompts, aktiveret når true.
formatvalgfri
Typeenum
Standardjpeg
jpegpng
Filformat for det resulterende billede.
request_idvalgfri
Typestring
Standard
Identifikator for anmodningen til at knytte et svar til den anmodning, der frembragte det.
openpose_image_urlvalgfri
Typeurl · image
URL til kontrolbilledet.
openpose_preprocessvalgfri
Typeboolean
Standardtrue
Styrer forbehandlingen af openpose-billedet.
depth_image_urlvalgfri
Typeurl · image
URL til kontrolbilledet.
depth_preprocessvalgfri
Typeboolean
Standardtrue
Styrer forbehandlingen af dybdebilledet.
teed_image_urlvalgfri
Typeurl · image
URL til kontrolbilledet.
teed_preprocessvalgfri
Typeboolean
Standardtrue
Styrer forbehandlingen af teed-billedet.
canny_image_urlvalgfri
Typeurl · image
URL til kontrolbilledet.
canny_preprocessvalgfri
Typeboolean
Standardtrue
Styrer forbehandlingen af canny-billedet.
normal_image_urlvalgfri
Typeurl · image
URL til kontrolbilledet.
normal_preprocessvalgfri
Typeboolean
Standardtrue
Styrer forbehandlingen af normalbilledet.
segmentation_image_urlvalgfri
Typeurl · image
URL til kontrolbilledet.
segmentation_preprocessvalgfri
Typeboolean
Standardtrue
Styrer forbehandlingen af segmenteringsbilledet.
påkrævet Kanonisk navn, også accepteret

Filparametre accepterer en offentlig https://-URL, en data:-URI på op til 10 MB eller file_url fra en upload. Filer

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sdxl-controlnet-union/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": 12,
    "usd": "0.012",
    "charged": 12,
    "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"
  },
  "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"
  }
}
Dine filer, dit valgHver outputs[].url er en kopi på vores lagring: gemt for altid (betales pr. GB-måned) eller 7 dage gratis, afhængigt af din kontoindstilling eller ?storage=.
Samme struktur for alle modellertype, url, content_type, width, height og duration for billeder, video og lyd. output er modellens eget resultatobjekt.
Outputfelter
images
array of object {url, width, height, content_type}Filoplysninger for de genererede billeder.
timings
object
seed
integerSeed til billedgenerering, inklusive den tilfældigt valgte værdi, hvis inputtet ikke angav en seed; ellers gentages den angivne værdi.
has_nsfw_concepts
array of booleanAngiver, om NSFW-koncepter forekommer i de genererede billeder.
prompt
stringPrompt brugt under billedgenerering.

Flere modeller: Billedredigering

Til AI-agenter: Denne side som Markdown findes på https://doitong.com/da/developers/models/sdxl-controlnet-union/inpainting.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt