Przejdź do treści

IC-Light-v2 for Image Relighting

Integracja

Identyfikator modelu 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"

To żądanie: ≈0,40 $ 400 kredytów API Uruchom na tej stronie

Uzyskaj klucz API
Open model Edycja obrazów #relighting#editing

Ponownie oświetla zdjęcie i zmienia jego tło zgodnie z opisem tekstowym

Open model · Obraz

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane

Prompt sterujący generowaniem obrazu.

•wymagane image_url
Upuść plik lub

Adres URL obrazu, który zostanie ponownie oświetlony.

image_size

Wymiary wygenerowanego obrazu.

num_images domyślnie 1

Liczba obrazów żądanych do wygenerowania.

Zaawansowane 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
domyślnie

Negatywny prompt określający niepożądane treści obrazu.

Upuść plik lub

Adres URL maski dla obrazu uwarunkowania ic-light.

initial_latent domyślnie None

Warunki oświetlenia przekazane do modelu.

output_format domyślnie jpeg

Format pliku wynikowego obrazu.

domyślnie 0.67

Przestarzały próg usuwania tła, który obecnie nie wpływa na wyniki. Zamierzone działanie polegało na wyostrzaniu masek przy wyższych ustawieniach.

domyślnie 28

Liczba kroków inferencji do wykonania.

domyślnie 1

Rzeczywista skala classifier-free guidance stosowana podczas generowania.

domyślnie 0.98

Siła stosowana podczas przebiegu w niskiej rozdzielczości.

domyślnie 0.95

Siła stosowana podczas przebiegu w wysokiej rozdzielczości; działa tylko, gdy enable_hr_fix ma wartość True.

domyślnie 0.5
domyślnie 5

Siła zgodności z promptem przy wyborze obrazu, wyrażona jako CFG (Classifier Free Guidance).

Ziarno powtarzalnych obrazów: identyczny prompt i ziarno tworzą identyczny obraz, gdy wersja modelu się nie zmieniła.

POST /run/iclight-v2?wait=20 wycena → 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"

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o IC-Light-v2 for Image Relighting

Przyjmuje obraz źródłowy (`image_url`) i `prompt` opisujący żądane oświetlenie oraz tło. `initial_latent` może ustawić kierunek światła (Left, Right, Top, Bottom), a opcjonalny `mask_image_url` steruje wynikiem. Oferuje `enable_hr_fix` dla przebiegu w wysokiej rozdzielczości, od 1 do 4 wyników przez `num_images` oraz wyjście jpeg lub png.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
promptwymagane
Typstring
Prompt sterujący generowaniem obrazu.
negative_promptopcjonalne
Typstring
Domyślne
Negatywny prompt określający niepożądane treści obrazu.
image_urlwymagane image
Typurl · image
Adres URL obrazu, który zostanie ponownie oświetlony.
mask_image_urlopcjonalne
Typurl · image
Adres URL maski dla obrazu uwarunkowania ic-light.
background_thresholdopcjonalne
Typnumber
Domyślne0.67
0,01 – 1
Przestarzały próg usuwania tła, który obecnie nie wpływa na wyniki. Zamierzone działanie polegało na wyostrzaniu masek przy wyższych ustawieniach.
image_sizeopcjonalne
Typobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Wymiary wygenerowanego obrazu.
num_inference_stepsopcjonalne
Typinteger
Domyślne28
1 – 50
Liczba kroków inferencji do wykonania.
seedopcjonalne
Typinteger | null
Ziarno powtarzalnych obrazów: identyczny prompt i ziarno tworzą identyczny obraz, gdy wersja modelu się nie zmieniła.
initial_latentopcjonalne
Typenum
DomyślneNone
NoneLeftRightTopBottom
Warunki oświetlenia przekazane do modelu.
enable_hr_fixopcjonalne
Typboolean
Domyślnefalse
Włącza HR fix.
num_imagesopcjonalne num_outputs
Typinteger
Domyślne1
1 – 4
Liczba obrazów żądanych do wygenerowania.
cfgopcjonalne
Typnumber
Domyślne1
0,01 – 5
Rzeczywista skala classifier-free guidance stosowana podczas generowania.
lowres_denoiseopcjonalne
Typnumber
Domyślne0.98
0,01 – 1
Siła stosowana podczas przebiegu w niskiej rozdzielczości.
highres_denoiseopcjonalne
Typnumber
Domyślne0.95
0,01 – 1
Siła stosowana podczas przebiegu w wysokiej rozdzielczości; działa tylko, gdy enable_hr_fix ma wartość True.
hr_downscaleopcjonalne
Typnumber
Domyślne0.5
0,01 – 1
guidance_scaleopcjonalne
Typnumber
Domyślne5
0 – 20
Siła zgodności z promptem przy wyborze obrazu, wyrażona jako CFG (Classifier Free Guidance).
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Przełącznik kontroli bezpieczeństwa, którego ustawienie wyłączone wymaga autoryzacji konta. Bez tej autoryzacji każde żądanie jest sprawdzane niezależnie od ustawienia; true włącza kontroler.
output_formatopcjonalne
Typenum
Domyślnejpeg
jpegpng
Format pliku wynikowego obrazu.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

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"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
images
array of object {url, width, height, content_type}Informacje o plikach wygenerowanych obrazów.
timings
object
seed
integerZiarno generowania obrazu, zawierające wartość wybraną losowo, jeśli dane wejściowe nie zawierały ziarna; w przeciwnym razie powtarza podaną wartość.
has_nsfw_concepts
array of booleanWskazuje, czy w wygenerowanych obrazach występują treści NSFW.
prompt
stringPrompt używany podczas generowania obrazu.

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/iclight-v2.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt