Gå til innhold

SDXL ControlNet Union · Image to Image

Integrer

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"

Denne forespørselen: ≈0,048 $ 48 API-kreditter · ≈ 5,12 ₽ Kjør den på denne siden

Hent API-nøkkel
Stability AI Bilderedigering #diffusion#controlnet#composition

SDXL-bilde-til-bilde med veiledning fra flere ControlNet-er basert på positur-, dybde-, kant-, normal- eller segmenteringskontrollbilder

Stability AI · Bilde

Det første resultatet ditt kommer her

Bygg en forespørsel nedenfor og kjør den med API-nøkkelen din. Utdata kopieres til lagringen vår, lagret for alltid eller 7 dager gratis.

Bygg en forespørsel

Kontrollene genereres fra modellskjemaet. Koden og prisen oppdateres når du endrer dem.

•obligatorisk

Beskriv bildet du vil generere, med så mange detaljer som mulig for best mulig resultat.

•obligatorisk image_url
Slipp en fil, eller

Startbilde for generering, levert via URL.

image_size

Utdata-dimensjoner, automatisk bestemt fra kontrollbildet når ingen størrelse oppgis.

num_images standard 1

Antall bilder som etterspørres for generering.

Avansert 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 angir uønskede bildedetaljer. Den kan utelate farger, objekter, landskap eller finere trekk og egenskaper, for eksempel bart, uskarphet eller lav oppløsning.

Slipp en fil, eller

URL til kontrollbildet.

Slipp en fil, eller

URL til kontrollbildet.

Slipp en fil, eller

URL til kontrollbildet.

Slipp en fil, eller

URL til kontrollbildet.

Slipp en fil, eller

URL til kontrollbildet.

Slipp en fil, eller

URL til kontrollbildet.

safety_checker_version standard v1

Velg mellom en egendefinert ViT-sikkerhetskontroll (`v2`) og CompVis-kontrollen (`v1`, standarden).

format standard jpeg

Filformat for det resulterende bildet.

standard

Forespørsels-ID for å knytte et svar til forespørselen som produserte det.

standard 0.5

Styrken på betingelsen som brukes av ControlNet.

standard 35

Antall inferenssteg som skal kjøres.

standard 7.5

Styrke for prompt-etterlevelse ved bildeutvalg, uttrykt som CFG (Classifier Free Guidance).

standard 0.95

Grad av likhet mellom det genererte bildet og originalbildet.

Seed for å gjenskape bilder i Stable Diffusion. Et bilde kan gjenskapes nøyaktig ved hver kjøring ved å beholde modellversjon, prompt og seed uendret.

standard []

LoRA-vekter valgt for bruk, levert som en liste.

standard []

Embeddings valgt for bruk, levert som en liste.

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"

Kjør denne forespørselen

Nøkkelen din blir i denne nettleseren: Den sendes bare til Doitong API og lagres bare i localStorage hvis du krysser av for Husk. Hent en API-nøkkel

Om SDXL ControlNet Union · Image to Image

Transformerer et startbilde med en SDXL-basismodell styrt av en prompt og valgfrie kontrollbilder for openpose, dybdekart, teed, canny, normal og segmentering. Hver kontrollinndata har egen bryter for forhåndsbehandling. `strength` går fra 0.05 til 1, `num_inference_steps` fra 1 til 70, og opptil 8 bilder kan returneres per kall. LoRA-er og embedding-er kan angis, og utdata er jpeg eller png.

Parametere

Send enten det kanoniske navnet eller det opprinnelige navnet, ikke begge. Kanoniske navn

NavnType StandardTillatt Beskrivelse
promptobligatorisk
Typestring
Beskriv bildet du vil generere, med så mange detaljer som mulig for best mulig resultat.
controlnet_conditioning_scalevalgfritt
Typenumber
Standard0.5
0 – 1
Styrken på betingelsen som brukes av ControlNet.
image_urlobligatorisk image
Typeurl · image
Startbilde for generering, levert via URL.
negative_promptvalgfritt
Typestring
Standard
Negativ prompt som angir uønskede bildedetaljer. Den kan utelate farger, objekter, landskap eller finere trekk og egenskaper, for eksempel bart, uskarphet eller lav oppløsning.
image_sizevalgfritt
Typeobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Utdata-dimensjoner, automatisk bestemt fra kontrollbildet når ingen størrelse oppgis.
num_inference_stepsvalgfritt
Typeinteger
Standard35
1 – 70
Antall inferenssteg som skal kjøres.
guidance_scalevalgfritt
Typenumber
Standard7.5
0 – 20
Styrke for prompt-etterlevelse ved bildeutvalg, uttrykt som CFG (Classifier Free Guidance).
strengthvalgfritt
Typenumber
Standard0.95
0,05 – 1
Grad av likhet mellom det genererte bildet og originalbildet.
seedvalgfritt
Typeinteger | null
Seed for å gjenskape bilder i Stable Diffusion. Et bilde kan gjenskapes nøyaktig ved hver kjøring ved å beholde modellversjon, prompt og seed uendret.
num_imagesvalgfritt num_outputs
Typeinteger
Standard1
1 – 8
Antall bilder som etterspørres for generering.
lorasvalgfritt
Typeobject[]
Standard[]
LoRA-vekter valgt for bruk, levert som en liste.
loras[].forcevalgfritt
Typeboolean
Standardfalse
Om bruk av embedding er obligatorisk: true gjør det påkrevd.
loras[].pathobligatorisk
Typestring
Kilde for LoRA-vekter, angitt som en HF-modellidentifikator som løser seg til safetensors-vekter, eller som en safetensors-fil funnet via URL eller bane.
loras[].scalevalgfritt
Typenumber
Standard1
0 – 1
Faktor brukt på LoRA-vekten før den flettes inn i basismodellen.
embeddingsvalgfritt
Typeobject[]
Standard[]
Embeddings valgt for bruk, levert som en liste.
embeddings[].pathobligatorisk
Typestring
Embedding-vekter angitt med URL eller filbane.
embeddings[].tokensvalgfritt
Typestring[]
Liste over embedding-token, med automatisk navngivning når den utelates: hver vektor i embedding-filen får en token fra sekvensen <s0>, <s1>, ... .
enable_safety_checkervalgfritt
Typeboolean
Standardtrue
Aktivering av sikkerhetskontroll; true aktiverer kontroll.
safety_checker_versionvalgfritt
Typeenum
Standardv1
v1v2
Velg mellom en egendefinert ViT-sikkerhetskontroll (`v2`) og CompVis-kontrollen (`v1`, standarden).
expand_promptvalgfritt
Typeboolean
Standardfalse
Promptutvidelse med flere prompter, aktivert når true.
formatvalgfritt
Typeenum
Standardjpeg
jpegpng
Filformat for det resulterende bildet.
request_idvalgfritt
Typestring
Standard
Forespørsels-ID for å knytte et svar til forespørselen som produserte det.
preserve_aspect_ratiovalgfritt
Typeboolean
Standardfalse
Sett til true for å beholde det genererte bildets sideforhold selv når størrelsen overskrider grensen. For å oppnå riktige proporsjoner ved beskjæring etter generering, sett crop_output til True. Bredde- eller høydeverdier som ikke er delelige med 32, rundes fortsatt av til nærmeste multiplum av 32, og denne endringen beholder ikke sideforholdet som standard.
crop_outputvalgfritt
Typeboolean
Standardfalse
Beskjær genererte utdata til riktig sideforhold når verdien er true.
openpose_image_urlvalgfritt
Typeurl · image
URL til kontrollbildet.
openpose_preprocessvalgfritt
Typeboolean
Standardtrue
Styrer forbehandlingen av openpose-bildet.
depth_image_urlvalgfritt
Typeurl · image
URL til kontrollbildet.
depth_preprocessvalgfritt
Typeboolean
Standardtrue
Styrer forbehandlingen av dybdebildet.
teed_image_urlvalgfritt
Typeurl · image
URL til kontrollbildet.
teed_preprocessvalgfritt
Typeboolean
Standardtrue
Styrer forbehandlingen av teed-bildet.
canny_image_urlvalgfritt
Typeurl · image
URL til kontrollbildet.
canny_preprocessvalgfritt
Typeboolean
Standardtrue
Styrer forbehandlingen av canny-bildet.
normal_image_urlvalgfritt
Typeurl · image
URL til kontrollbildet.
normal_preprocessvalgfritt
Typeboolean
Standardtrue
Styrer forbehandlingen av normalbildet.
segmentation_image_urlvalgfritt
Typeurl · image
URL til kontrollbildet.
segmentation_preprocessvalgfritt
Typeboolean
Standardtrue
Styrer forbehandlingen av segmenteringsbildet.
obligatorisk Kanonisk navn, også godkjent

Filparametere tar imot en offentlig https:// URL, en data: URI på opptil 10 MB eller file_url fra en opplasting. Filer

Utdata

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"
  }
}
Filene dine, ditt valgHver outputs[].url er en kopi på lagringen vår: lagret for alltid (betalt per GB-måned) eller 7 dager gratis, styrt av kontoinnstillingen din eller ?storage=.
Samme struktur for hver modelltype, url, content_type, width, height og duration, for bilder, video og lyd. output er modellens eget resultatobjekt.
Utdatafelt
images
array of object {url, width, height, content_type}Filinformasjon for de genererte bildene.
timings
object
seed
integerSeed for bildegenerering, inkludert den tilfeldig valgte verdien hvis inndataene utelot en seed; ellers gjentas den oppgitte verdien.
has_nsfw_concepts
array of booleanAngir om NSFW-konsepter forekommer i de genererte bildene.
prompt
stringPrompt brukt under bildegenerering.

Flere modeller: Bilderedigering

For AI-agenter: Denne siden som Markdown finnes på https://doitong.com/no/developers/models/sdxl-controlnet-union/image-to-image.md. Alle modeller og veiledninger: https://doitong.com/developers/llms.txt