Naar inhoud springen

IC-Light-v2 for Image Relighting

Integreren

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

Deze request: ≈$ 0,40 400 API-tegoed Op deze pagina uitvoeren

API-sleutel ophalen
Open model Afbeelding bewerken #relighting#editing

Belicht een foto opnieuw en wijzigt de achtergrond volgens een tekstuele beschrijving

Open model · Afbeelding

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht

Prompt die afbeeldingsgeneratie stuurt.

•verplicht image_url
Sleep een bestand hierheen of

URL die verwijst naar de afbeelding die opnieuw wordt belicht.

image_size

Afmetingen van de gegenereerde afbeelding.

num_images standaard 1

Aantal afbeeldingen dat voor generatie wordt aangevraagd.

Geavanceerd 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
standaard

Negatieve prompt met ongewenste afbeeldingsinhoud.

Sleep een bestand hierheen of

Masker-URL voor de ic-light-conditioneringsafbeelding.

initial_latent standaard None

Belichtingsomstandigheden die aan het model worden verstrekt.

output_format standaard jpeg

Bestandsindeling van de resulterende afbeelding.

standaard 0.67

Verouderde drempelwaarde voor achtergrondverwijdering zonder huidig effect op resultaten. Het beoogde gedrag is maskers bij hogere instellingen scherper maken.

standaard 28

Aantal uit te voeren inferentiestappen.

standaard 1

De daadwerkelijke classifier-free guidance-schaal die tijdens de generatie wordt toegepast.

standaard 0.98

Sterkte die tijdens de lage-resolutiepass wordt toegepast.

standaard 0.95

Sterkte die tijdens de hoge-resolutiepass wordt toegepast; werkt alleen wanneer enable_hr_fix True is.

standaard 0.5
standaard 5

Sterkte waarmee de prompt wordt gevolgd bij beeldselectie, uitgedrukt als CFG (Classifier Free Guidance).

Seed voor reproduceerbare afbeeldingen: een identieke prompt en seed produceren een identieke afbeelding als de modelversie ongewijzigd is.

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

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over IC-Light-v2 for Image Relighting

Gebruikt een bronafbeelding (`image_url`) en een `prompt` die de gewenste belichting en achtergrond beschrijft. `initial_latent` kan de lichtrichting instellen (Left, Right, Top, Bottom) en een optionele `mask_image_url` stuurt het resultaat. Biedt `enable_hr_fix` voor een hoge-resolutiepassage, 1-4 uitvoerafbeeldingen via `num_images` en uitvoer in jpeg of png.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
promptverplicht
Typestring
Prompt die afbeeldingsgeneratie stuurt.
negative_promptoptioneel
Typestring
Standaard
Negatieve prompt met ongewenste afbeeldingsinhoud.
image_urlverplicht image
Typeurl · image
URL die verwijst naar de afbeelding die opnieuw wordt belicht.
mask_image_urloptioneel
Typeurl · image
Masker-URL voor de ic-light-conditioneringsafbeelding.
background_thresholdoptioneel
Typenumber
Standaard0.67
0,01 – 1
Verouderde drempelwaarde voor achtergrondverwijdering zonder huidig effect op resultaten. Het beoogde gedrag is maskers bij hogere instellingen scherper maken.
image_sizeoptioneel
Typeobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Afmetingen van de gegenereerde afbeelding.
num_inference_stepsoptioneel
Typeinteger
Standaard28
1 – 50
Aantal uit te voeren inferentiestappen.
seedoptioneel
Typeinteger | null
Seed voor reproduceerbare afbeeldingen: een identieke prompt en seed produceren een identieke afbeelding als de modelversie ongewijzigd is.
initial_latentoptioneel
Typeenum
StandaardNone
NoneLeftRightTopBottom
Belichtingsomstandigheden die aan het model worden verstrekt.
enable_hr_fixoptioneel
Typeboolean
Standaardfalse
Schakelt HR fix in.
num_imagesoptioneel num_outputs
Typeinteger
Standaard1
1 – 4
Aantal afbeeldingen dat voor generatie wordt aangevraagd.
cfgoptioneel
Typenumber
Standaard1
0,01 – 5
De daadwerkelijke classifier-free guidance-schaal die tijdens de generatie wordt toegepast.
lowres_denoiseoptioneel
Typenumber
Standaard0.98
0,01 – 1
Sterkte die tijdens de lage-resolutiepass wordt toegepast.
highres_denoiseoptioneel
Typenumber
Standaard0.95
0,01 – 1
Sterkte die tijdens de hoge-resolutiepass wordt toegepast; werkt alleen wanneer enable_hr_fix True is.
hr_downscaleoptioneel
Typenumber
Standaard0.5
0,01 – 1
guidance_scaleoptioneel
Typenumber
Standaard5
0 – 20
Sterkte waarmee de prompt wordt gevolgd bij beeldselectie, uitgedrukt als CFG (Classifier Free Guidance).
enable_safety_checkeroptioneel
Typeboolean
Standaardtrue
Schakelaar voor veiligheidscontrole waarvan de uitgeschakelde instelling accountautorisatie vereist. Zonder die autorisatie wordt elke request gecontroleerd, ongeacht de instelling; true schakelt de controle in.
output_formatoptioneel
Typeenum
Standaardjpeg
jpegpng
Bestandsindeling van de resulterende afbeelding.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
images
array of object {url, width, height, content_type}Bestandsinformatie voor de gegenereerde afbeeldingen.
timings
object
seed
integerSeed voor afbeeldingsgeneratie, inclusief de willekeurig gekozen waarde als de invoer geen seed bevatte; anders wordt de opgegeven waarde herhaald.
has_nsfw_concepts
array of booleanGeeft aan of NSFW-concepten in de gegenereerde afbeeldingen voorkomen.
prompt
stringPrompt die tijdens afbeeldingsgeneratie wordt gebruikt.

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/iclight-v2.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt