Vai al contenuto

IC-Light-v2 for Image Relighting

Integra

ID del modello 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"

Questa richiesta: ≈0,40 $ 400 crediti API Esegui in questa pagina

Ottieni la chiave API
Open model Modifica immagini #relighting#editing

Modifica l'illuminazione di una foto e cambia lo sfondo in base a una descrizione testuale

Open model · Immagine

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio

Prompt che guida la generazione di immagini.

•obbligatorio image_url
Trascina un file oppure

URL dell'immagine a cui applicare il relighting.

image_size

Dimensioni dell'immagine generata.

num_images predefinito 1

Numero di immagini richiesto per la generazione.

Avanzate 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
predefinito

Prompt negativo che specifica il contenuto indesiderato dell'immagine.

Trascina un file oppure

URL della maschera per l'immagine di condizionamento ic-light.

initial_latent predefinito None

Condizioni di illuminazione fornite al modello.

output_format predefinito jpeg

Formato del file dell'immagine risultante.

predefinito 0.67

Soglia deprecata per la rimozione dello sfondo, senza effetto attuale sui risultati. Il comportamento previsto era rendere più nitide le maschere con valori elevati.

predefinito 28

Numero di passaggi di inferenza da eseguire.

predefinito 1

Scala effettiva della guidance classifier-free applicata durante la generazione.

predefinito 0.98

Intensità applicata durante il passaggio a bassa risoluzione.

predefinito 0.95

Intensità applicata durante il passaggio ad alta risoluzione; ha effetto solo quando enable_hr_fix è True.

predefinito 0.5
predefinito 5

Intensità di aderenza al prompt per la selezione dell'immagine, espressa come CFG (Classifier Free Guidance).

Seed per immagini riproducibili: prompt e seed identici producono un'immagine identica quando la versione del modello non cambia.

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

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su IC-Light-v2 for Image Relighting

Riceve un'immagine sorgente (`image_url`) e un `prompt` che descrive l'illuminazione e lo sfondo desiderati. `initial_latent` può impostare la direzione della luce (Left, Right, Top, Bottom) e un `mask_image_url` opzionale condiziona il risultato. Offre `enable_hr_fix` per un passaggio ad alta risoluzione, da 1 a 4 output tramite `num_images` e output jpeg o png.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
promptobbligatorio
Tipostring
Prompt che guida la generazione di immagini.
negative_promptfacoltativo
Tipostring
Predefinito
Prompt negativo che specifica il contenuto indesiderato dell'immagine.
image_urlobbligatorio image
Tipourl · image
URL dell'immagine a cui applicare il relighting.
mask_image_urlfacoltativo
Tipourl · image
URL della maschera per l'immagine di condizionamento ic-light.
background_thresholdfacoltativo
Tiponumber
Predefinito0.67
0,01 – 1
Soglia deprecata per la rimozione dello sfondo, senza effetto attuale sui risultati. Il comportamento previsto era rendere più nitide le maschere con valori elevati.
image_sizefacoltativo
Tipoobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensioni dell'immagine generata.
num_inference_stepsfacoltativo
Tipointeger
Predefinito28
1 – 50
Numero di passaggi di inferenza da eseguire.
seedfacoltativo
Tipointeger | null
Seed per immagini riproducibili: prompt e seed identici producono un'immagine identica quando la versione del modello non cambia.
initial_latentfacoltativo
Tipoenum
PredefinitoNone
NoneLeftRightTopBottom
Condizioni di illuminazione fornite al modello.
enable_hr_fixfacoltativo
Tipoboolean
Predefinitofalse
Abilita HR fix.
num_imagesfacoltativo num_outputs
Tipointeger
Predefinito1
1 – 4
Numero di immagini richiesto per la generazione.
cfgfacoltativo
Tiponumber
Predefinito1
0,01 – 5
Scala effettiva della guidance classifier-free applicata durante la generazione.
lowres_denoisefacoltativo
Tiponumber
Predefinito0.98
0,01 – 1
Intensità applicata durante il passaggio a bassa risoluzione.
highres_denoisefacoltativo
Tiponumber
Predefinito0.95
0,01 – 1
Intensità applicata durante il passaggio ad alta risoluzione; ha effetto solo quando enable_hr_fix è True.
hr_downscalefacoltativo
Tiponumber
Predefinito0.5
0,01 – 1
guidance_scalefacoltativo
Tiponumber
Predefinito5
0 – 20
Intensità di aderenza al prompt per la selezione dell'immagine, espressa come CFG (Classifier Free Guidance).
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Interruttore del controllo di sicurezza la cui disattivazione richiede l'autorizzazione dell'account. Senza tale autorizzazione, ogni richiesta viene controllata indipendentemente dall'impostazione; true abilita il controllo.
output_formatfacoltativo
Tipoenum
Predefinitojpeg
jpegpng
Formato del file dell'immagine risultante.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
images
array of object {url, width, height, content_type}Informazioni sui file delle immagini generate.
timings
object
seed
integerSeed della generazione di immagini, incluso il valore scelto casualmente se l'input non forniva un seed; altrimenti ripete il valore fornito.
has_nsfw_concepts
array of booleanIndica se nelle immagini generate compaiono concetti NSFW.
prompt
stringPrompt usato durante la generazione di immagini.

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/iclight-v2.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt