Hoppa till innehåll

SDXL ControlNet Union · Image to Image

Integrera

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

Den här begäran: ≈0,048 $ 48 API-krediter · ≈ 5,12 ₽ Kör den på den här sidan

Hämta API-nyckel
Stability AI Bildredigering #diffusion#controlnet#composition

SDXL-bild-till-bild med styrning från flera ControlNet-kontrollbilder för pose, djup, kanter, normaler eller segmentering

Stability AI · Bild

Ditt första resultat visas här

Skapa en begäran nedan och kör den med din API-nyckel. Utdata kopieras till vår lagring och sparas för alltid eller 7 dagar kostnadsfritt.

Skapa en begäran

Kontrollerna genereras från modellschemat. Koden och priset uppdateras när du ändrar dem.

•obligatoriskt

Beskriv bilden du vill generera med så mycket detalj som möjligt för bästa resultat.

•obligatoriskt image_url
Släpp en fil eller

Startbild för genereringen, tillhandahållen via URL.

image_size

Utdata-dimensioner, automatiskt bestämda från kontrollbilden när ingen storlek anges.

num_images standard 1

Antal bilder som begärs för generering.

Avancerat 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 · preserve_aspect_ratio · crop_output · openpose_preprocess · depth_preprocess · teed_preprocess · canny_preprocess · normal_preprocess · segmentation_preprocess · loras · embeddings
standard

Negativ prompt som anger oönskade bilddetaljer. Den kan utesluta färger, objekt, miljöer eller finare detaljer och egenskaper, såsom mustasch, oskärpa eller låg upplösning.

Släpp en fil eller

URL till kontrollbilden.

Släpp en fil eller

URL till kontrollbilden.

Släpp en fil eller

URL till kontrollbilden.

Släpp en fil eller

URL till kontrollbilden.

Släpp en fil eller

URL till kontrollbilden.

Släpp en fil eller

URL till kontrollbilden.

safety_checker_version standard v1

Välj mellan en anpassad ViT-säkerhetskontroll (`v2`) och CompVis-kontrollen (`v1`, standard).

format standard jpeg

Filformat för den resulterande bilden.

standard

Identifierare för begäran som används för att koppla ett svar till den begäran som genererade det.

standard 0.5

Styrka för den conditioning som tillämpas av ControlNet.

standard 35

Antal inferenssteg som ska köras.

standard 7.5

Styrka för promptföljsamhet vid bildval, uttryckt som CFG (Classifier Free Guidance).

standard 0.95

Grad av likhet mellan den genererade bilden och den ursprungliga bilden.

Startvärde för att återskapa bilder i Stable Diffusion. En bild kan återskapas exakt vid varje körning genom att lämna modellversion, prompt och startvärde oförändrade.

standard []

LoRA-vikter som valts för användning, angivna som en lista.

standard []

Embeddings som valts för användning, angivna som en lista.

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

Kör den här begäran

Din nyckel stannar i den här webbläsaren: den skickas endast till Doitong API och sparas endast i localStorage om du markerar Kom ihåg. Hämta en API-nyckel

Om SDXL ControlNet Union · Image to Image

Förvandlar en startbild med en SDXL-bas som styrs av en prompt och valfria kontrollbilder för openpose, djupkarta, teed, canny, normal och segmentering. Varje kontrollindata har en egen förbehandlingsväxel. `strength` går från 0.05 till 1, `num_inference_steps` från 1 till 70 och upp till 8 bilder kan returneras per anrop. LoRA:er och inbäddningar kan anges, och utdata är jpeg eller png.

Parametrar

Skicka antingen det kanoniska namnet eller det inbyggda namnet, inte båda. Kanoniska namn

NamnTyp StandardTillåtna Beskrivning
promptobligatoriskt
Typstring
Beskriv bilden du vill generera med så mycket detalj som möjligt för bästa resultat.
controlnet_conditioning_scalevalfritt
Typnumber
Standard0.5
0 – 1
Styrka för den conditioning som tillämpas av ControlNet.
image_urlobligatoriskt image
Typurl · image
Startbild för genereringen, tillhandahållen via URL.
negative_promptvalfritt
Typstring
Standard
Negativ prompt som anger oönskade bilddetaljer. Den kan utesluta färger, objekt, miljöer eller finare detaljer och egenskaper, såsom mustasch, oskärpa eller låg upplösning.
image_sizevalfritt
Typobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Utdata-dimensioner, automatiskt bestämda från kontrollbilden när ingen storlek anges.
num_inference_stepsvalfritt
Typinteger
Standard35
1 – 70
Antal inferenssteg som ska köras.
guidance_scalevalfritt
Typnumber
Standard7.5
0 – 20
Styrka för promptföljsamhet vid bildval, uttryckt som CFG (Classifier Free Guidance).
strengthvalfritt
Typnumber
Standard0.95
0,05 – 1
Grad av likhet mellan den genererade bilden och den ursprungliga bilden.
seedvalfritt
Typinteger | null
Startvärde för att återskapa bilder i Stable Diffusion. En bild kan återskapas exakt vid varje körning genom att lämna modellversion, prompt och startvärde oförändrade.
num_imagesvalfritt num_outputs
Typinteger
Standard1
1 – 8
Antal bilder som begärs för generering.
lorasvalfritt
Typobject[]
Standard[]
LoRA-vikter som valts för användning, angivna som en lista.
loras[].forcevalfritt
Typboolean
Standardfalse
Om användning av embedding är obligatorisk: true gör den obligatorisk.
loras[].pathobligatoriskt
Typstring
Källa för LoRA-vikter, angiven som en HF-modellidentifierare som pekar på safetensors-vikter eller som en safetensors-fil som nås via URL eller sökväg.
loras[].scalevalfritt
Typnumber
Standard1
0 – 1
Multiplikator som tillämpas på LoRA-vikten innan den slås samman med basmodellen.
embeddingsvalfritt
Typobject[]
Standard[]
Embeddings som valts för användning, angivna som en lista.
embeddings[].pathobligatoriskt
Typstring
Embedding-vikter som anges med URL eller filsökväg.
embeddings[].tokensvalfritt
Typstring[]
Lista över embedding-token, med automatisk namngivning när den utelämnas: varje vektor i embedding-filen får en token från sekvensen <s0>, <s1>, ... .
enable_safety_checkervalfritt
Typboolean
Standardtrue
Aktivering av säkerhetskontroll; true aktiverar kontrollen.
safety_checker_versionvalfritt
Typenum
Standardv1
v1v2
Välj mellan en anpassad ViT-säkerhetskontroll (`v2`) och CompVis-kontrollen (`v1`, standard).
expand_promptvalfritt
Typboolean
Standardfalse
Promptutvidgning med ytterligare promptar, aktiverad när true.
formatvalfritt
Typenum
Standardjpeg
jpegpng
Filformat för den resulterande bilden.
request_idvalfritt
Typstring
Standard
Identifierare för begäran som används för att koppla ett svar till den begäran som genererade det.
preserve_aspect_ratiovalfritt
Typboolean
Standardfalse
Ange true för att behålla den genererade bildens bildformat även när storleken överskrider gränsen. Ange crop_output till True för att få korrekta proportioner genom beskärning efter genereringen. Bredd- eller höjdvärden som inte är delbara med 32 avrundas fortfarande till närmaste multipel av 32, och denna storleksändring behåller inte bildformatet som standard.
crop_outputvalfritt
Typboolean
Standardfalse
Beskär den genererade utdatan till korrekt bildformat när värdet är true.
openpose_image_urlvalfritt
Typurl · image
URL till kontrollbilden.
openpose_preprocessvalfritt
Typboolean
Standardtrue
Styr förbearbetningen av openpose-bilden.
depth_image_urlvalfritt
Typurl · image
URL till kontrollbilden.
depth_preprocessvalfritt
Typboolean
Standardtrue
Styr förbearbetningen av djupbilden.
teed_image_urlvalfritt
Typurl · image
URL till kontrollbilden.
teed_preprocessvalfritt
Typboolean
Standardtrue
Styr förbearbetningen av teed-bilden.
canny_image_urlvalfritt
Typurl · image
URL till kontrollbilden.
canny_preprocessvalfritt
Typboolean
Standardtrue
Styr förbearbetningen av canny-bilden.
normal_image_urlvalfritt
Typurl · image
URL till kontrollbilden.
normal_preprocessvalfritt
Typboolean
Standardtrue
Styr förbearbetningen av normalbilden.
segmentation_image_urlvalfritt
Typurl · image
URL till kontrollbilden.
segmentation_preprocessvalfritt
Typboolean
Standardtrue
Styr förbearbetningen av segmenteringsbilden.
obligatoriskt Kanoniskt namn, accepteras också

Filparametrar tar emot en offentlig https://-URL, en data:-URI på upp till 10 MB eller file_url från en uppladdning. Filer

Resultat

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sdxl-controlnet-union/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": 48,
    "usd": "0.048",
    "charged": 48,
    "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"
  },
  "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"
  }
}
Dina filer, ditt valVarje outputs[].url är en kopia i vår lagring: sparad för alltid (debiteras per GB-månad) eller 7 dagar kostnadsfritt, enligt din kontoinställning eller ?storage=.
Samma struktur för varje modelltype, url, content_type, width, height och duration, för bilder, video och ljud. output är modellens eget resultatobjekt.
Resultatets fält
images
array of object {url, width, height, content_type}Filinformation för de genererade bilderna.
timings
object
seed
integerSeed för bildgenerering, inklusive det slumpmässigt valda värdet om indata saknade seed; annars upprepas det angivna värdet.
has_nsfw_concepts
array of booleanAnger om NSFW-koncept förekommer i de genererade bilderna.
prompt
stringPrompt som används under bildgenereringen.

Fler modeller: Bildredigering

För AI-agenter: den här sidan som Markdown finns på https://doitong.com/sv/developers/models/sdxl-controlnet-union/image-to-image.md. Alla modeller och guider: https://doitong.com/developers/llms.txt