Zum Inhalt springen

IC-Light-v2 for Image Relighting

Integrieren

Modell-ID iclight-v2
# 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/iclight-v2?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Diese Anfrage: ≈0,40 $ 400 API-Credits Auf dieser Seite ausführen

API-Schlüssel abrufen
Open model Bildbearbeitung #relighting#editing

Beleuchtet ein Foto neu und ändert seinen Hintergrund anhand einer Textbeschreibung

Open model · 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

Prompt zur Steuerung der Bildgenerierung.

•erforderlich image_url
Datei ablegen oder

URL zum Bild, das neu beleuchtet werden soll.

image_size

Abmessungen des generierten Bildes.

num_images Standard 1

Für die Generierung angeforderte Bildanzahl.

Erweitert negative_prompt · mask_image_url · initial_latent · output_format · background_threshold · num_inference_steps · cfg · lowres_denoise · highres_denoise · hr_downscale · guidance_scale · seed · enable_hr_fix · enable_safety_checker
Standard

Negativer Prompt zur Angabe unerwünschter Bildinhalte.

Datei ablegen oder

Masken-URL für das Konditionierungsbild von ic-light.

initial_latent Standard None

Dem Modell vorgegebene Beleuchtungsbedingungen.

output_format Standard jpeg

Dateiformat des resultierenden Bilds.

Standard 0.67

Veralteter Schwellenwert für die Hintergrundentfernung, der derzeit keine Auswirkung auf die Ergebnisse hat. Vorgesehen ist, dass höhere Einstellungen die Masken schärfen.

Standard 28

Anzahl der auszuführenden Inferenzschritte.

Standard 1

Tatsächlich bei der Generierung angewendeter Skalierungsfaktor für die klassifikatorfreie Steuerung.

Standard 0.98

Im Durchlauf mit niedriger Auflösung angewendete Stärke.

Standard 0.95

Im Durchlauf mit hoher Auflösung angewendete Stärke; wirkt nur, wenn enable_hr_fix auf True gesetzt ist.

Standard 0.5
Standard 5

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

Seed für reproduzierbare Bilder: Ein identischer Prompt und Seed erzeugen bei unveränderter Modellversion ein identisches Bild.

POST /run/iclight-v2?wait=20 Preis → 0,40 $
# 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/iclight-v2?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.com/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 IC-Light-v2 for Image Relighting

Nimmt ein Quellbild (`image_url`) und einen `prompt` entgegen, der die gewünschte Beleuchtung und den Hintergrund beschreibt. `initial_latent` kann die Lichtrichtung festlegen (Left, Right, Top, Bottom), und ein optionales `mask_image_url` beeinflusst das Ergebnis. Bietet `enable_hr_fix` für einen hochauflösenden Durchlauf, 1-4 Ausgaben über `num_images` sowie jpeg- oder png-Ausgabe.

Parameter

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

NameTyp StandardZulässig Beschreibung
prompterforderlich
Typstring
Prompt zur Steuerung der Bildgenerierung.
negative_promptoptional
Typstring
Standard
Negativer Prompt zur Angabe unerwünschter Bildinhalte.
image_urlerforderlich image
Typurl · image
URL zum Bild, das neu beleuchtet werden soll.
mask_image_urloptional
Typurl · image
Masken-URL für das Konditionierungsbild von ic-light.
background_thresholdoptional
Typnumber
Standard0.67
0,01 – 1
Veralteter Schwellenwert für die Hintergrundentfernung, der derzeit keine Auswirkung auf die Ergebnisse hat. Vorgesehen ist, dass höhere Einstellungen die Masken schärfen.
image_sizeoptional
Typobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Abmessungen des generierten Bildes.
num_inference_stepsoptional
Typinteger
Standard28
1 – 50
Anzahl der auszuführenden Inferenzschritte.
seedoptional
Typinteger | null
Seed für reproduzierbare Bilder: Ein identischer Prompt und Seed erzeugen bei unveränderter Modellversion ein identisches Bild.
initial_latentoptional
Typenum
StandardNone
NoneLeftRightTopBottom
Dem Modell vorgegebene Beleuchtungsbedingungen.
enable_hr_fixoptional
Typboolean
Standardfalse
Aktiviert die HR-Korrektur.
num_imagesoptional num_outputs
Typinteger
Standard1
1 – 4
Für die Generierung angeforderte Bildanzahl.
cfgoptional
Typnumber
Standard1
0,01 – 5
Tatsächlich bei der Generierung angewendeter Skalierungsfaktor für die klassifikatorfreie Steuerung.
lowres_denoiseoptional
Typnumber
Standard0.98
0,01 – 1
Im Durchlauf mit niedriger Auflösung angewendete Stärke.
highres_denoiseoptional
Typnumber
Standard0.95
0,01 – 1
Im Durchlauf mit hoher Auflösung angewendete Stärke; wirkt nur, wenn enable_hr_fix auf True gesetzt ist.
hr_downscaleoptional
Typnumber
Standard0.5
0,01 – 1
guidance_scaleoptional
Typnumber
Standard5
0 – 20
Stärke der Prompt-Treue bei der Bildauswahl, ausgedrückt als CFG (Classifier Free Guidance).
enable_safety_checkeroptional
Typboolean
Standardtrue
Schalter für die Sicherheitsprüfung, dessen Deaktivierung eine Kontoberechtigung erfordert. Ohne diese Berechtigung wird jede Anfrage unabhängig von der Einstellung geprüft; true aktiviert die Prüfung.
output_formatoptional
Typenum
Standardjpeg
jpegpng
Dateiformat des resultierenden Bilds.
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": "iclight-v2",
  "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": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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.

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