Zum Inhalt springen

ControlNet SDXL

Integrieren

Modell-ID fast-sdxl-controlnet-canny
# 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?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"
  }'

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

Diese Anfrage: ≈0,015 $ 15 API-Credits · ≈ 1,60 ₽ Auf dieser Seite ausführen

API-Schlüssel abrufen
Stability AI Text zu Bild Schnell #diffusion#controlnet#manipulation

SDXL Text-zu-Bild, gesteuert durch ein Kontrollbild für kompositionsgebundene Generierung

Stability AI · Bild

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

•erforderlich

Beschreiben Sie das gewünschte Bild möglichst detailliert, um die besten Ergebnisse zu erzielen.

•erforderlich
Datei ablegen oder

URL zum Steuerbild.

image_size

Ausgabeabmessungen, die automatisch aus dem Steuerbild bestimmt werden, wenn keine Größe angegeben ist.

num_images Standard 1

Für die Generierung angeforderte Bildanzahl.

Erweitert negative_prompt · safety_checker_version · format · request_id · controlnet_conditioning_scale · num_inference_steps · guidance_scale · seed · enable_safety_checker · expand_prompt · loras · embeddings
Standard

Negativer Prompt mit auszuschließenden Bilddetails, darunter Farben, Objekte, Szenerie oder feinere Merkmale. Beispiele sind Schnurrbart, Unschärfe oder niedrige Auflösung.

safety_checker_version Standard v1

Zwischen einem benutzerdefinierten ViT-Sicherheitsprüfer (`v2`) und dem CompVis-Prüfer (`v1`, der Standard) wählen.

format Standard jpeg

Dateiformat des resultierenden Bilds.

Standard

Anfragekennung zur Zuordnung einer Antwort zu der Anfrage, die sie erzeugt hat.

Standard 0.5

Stärke der durch ControlNet angewendeten Konditionierung.

Standard 35

Anzahl der auszuführenden Inferenzschritte.

Standard 7.5

Stärke der Prompt-Treue bei der Bildauswahl, ausgedrückt als CFG (Classifier Free Guidance).

Seed zur Reproduktion von Bildern in Stable Diffusion. Ein Bild kann bei jedem Durchlauf exakt reproduziert werden, wenn Modellversion, Prompt und Seed unverändert bleiben.

Standard []

Zur Verwendung ausgewählte LoRA-Gewichte, als Liste bereitgestellt.

Standard []

Zur Verwendung ausgewählte Embeddings, als Liste bereitgestellt.

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

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

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über ControlNet SDXL

Erzeugt Bilder aus einem `prompt` und einem erforderlichen `control_image_url`, das das Layout steuert. `controlnet_conditioning_scale` reicht von 0 bis 1 (Standard 0.5). Die Ausgabegröße wird aus dem Kontrollbild abgeleitet, sofern `image_size` nicht gesetzt ist. Unterstützt bis zu 8 Bilder pro Aufruf, bis zu 70 Schritte, LoRAs und Embeddings.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
prompterforderlich
Typstring
Beschreiben Sie das gewünschte Bild möglichst detailliert, um die besten Ergebnisse zu erzielen.
control_image_urlerforderlich
Typurl · image
URL zum Steuerbild.
controlnet_conditioning_scaleoptional
Typnumber
Standard0.5
0 – 1
Stärke der durch ControlNet angewendeten Konditionierung.
negative_promptoptional
Typstring
Standard
Negativer Prompt mit auszuschließenden Bilddetails, darunter Farben, Objekte, Szenerie oder feinere Merkmale. Beispiele sind Schnurrbart, Unschärfe oder niedrige Auflösung.
image_sizeoptional
Typobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Ausgabeabmessungen, die automatisch aus dem Steuerbild bestimmt werden, wenn keine Größe angegeben ist.
num_inference_stepsoptional
Typinteger
Standard35
1 – 70
Anzahl der auszuführenden Inferenzschritte.
seedoptional
Typinteger | null
Seed zur Reproduktion von Bildern in Stable Diffusion. Ein Bild kann bei jedem Durchlauf exakt reproduziert werden, wenn Modellversion, Prompt und Seed unverändert bleiben.
guidance_scaleoptional
Typnumber
Standard7.5
0 – 20
Stärke der Prompt-Treue bei der Bildauswahl, ausgedrückt als CFG (Classifier Free Guidance).
num_imagesoptional num_outputs
Typinteger
Standard1
1 – 8
Für die Generierung angeforderte Bildanzahl.
lorasoptional
Typobject[]
Standard[]
Zur Verwendung ausgewählte LoRA-Gewichte, als Liste bereitgestellt.
loras[].forceoptional
Typboolean
Standardfalse
Gibt an, ob die Verwendung von Embeddings erforderlich ist: true macht sie verpflichtend.
loras[].patherforderlich
Typstring
Quelle der LoRA-Gewichte, angegeben als HF-Modellkennung, die zu Safetensors-Gewichten aufgelöst wird, oder als Safetensors-Datei, die über URL oder Pfad gefunden wird.
loras[].scaleoptional
Typnumber
Standard1
0 – 1
Multiplikator, der vor dem Zusammenführen mit dem Basismodell auf das LoRA-Gewicht angewendet wird.
embeddingsoptional
Typobject[]
Standard[]
Zur Verwendung ausgewählte Embeddings, als Liste bereitgestellt.
embeddings[].patherforderlich
Typstring
Über URL oder Dateipfad angegebene Embedding-Gewichte.
embeddings[].tokensoptional
Typstring[]
Embedding-Token-Liste mit automatischer Benennung, wenn sie weggelassen wird: Jeder Vektor in der Embedding-Datei erhält ein Token aus der Sequenz <s0>, <s1>, ... .
enable_safety_checkeroptional
Typboolean
Standardtrue
Aktivierung der Sicherheitsprüfung; true aktiviert die Prüfung.
safety_checker_versionoptional
Typenum
Standardv1
v1v2
Zwischen einem benutzerdefinierten ViT-Sicherheitsprüfer (`v2`) und dem CompVis-Prüfer (`v1`, der Standard) wählen.
expand_promptoptional
Typboolean
Standardfalse
Prompt-Erweiterung mit zusätzlichen Prompts, aktiviert, wenn true.
formatoptional
Typenum
Standardjpeg
jpegpng
Dateiformat des resultierenden Bilds.
request_idoptional
Typstring
Standard
Anfragekennung zur Zuordnung einer Antwort zu der Anfrage, die sie erzeugt hat.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "fast-sdxl-controlnet-canny",
  "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": {
    "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"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
images
array of object {url, width, height, content_type}Dateiinformationen für die generierten Bilder.
timings
object
seed
integerSeed der Bildgenerierung einschließlich des zufällig gewählten Werts, falls die Eingabe keinen Seed enthielt; andernfalls wird der angegebene Wert wiederholt.
has_nsfw_concepts
array of booleanGibt an, ob NSFW-Konzepte in den generierten Bildern vorkommen.
prompt
stringWährend der Bildgenerierung verwendeter Prompt.

Weitere Modelle: Text zu Bild

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/fast-sdxl-controlnet-canny.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt