Lompat ke konten

IC-Light-v2 for Image Relighting

Integrasikan

ID model 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"

Permintaan ini: ≈$0,40 400 kredit API Jalankan di halaman ini

Dapatkan kunci API
Open model Pengeditan Gambar #relighting#editing

Mengubah pencahayaan foto dan latarnya berdasarkan deskripsi teks

Open model · Gambar

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib

Prompt yang memandu pembuatan gambar.

•wajib image_url
Jatuhkan file, atau

URL yang mengarah ke gambar yang akan diberi pencahayaan ulang.

image_size

Dimensi gambar yang dihasilkan.

num_images bawaan 1

Jumlah gambar yang diminta untuk dibuat.

Lanjutan 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
bawaan

Prompt negatif yang menentukan konten gambar yang tidak diinginkan.

Jatuhkan file, atau

URL mask untuk gambar conditioning ic-light.

initial_latent bawaan None

Kondisi pencahayaan yang diberikan kepada model.

output_format bawaan jpeg

Format file untuk gambar hasil.

bawaan 0.67

Ambang penghapusan latar belakang yang sudah deprecated dan saat ini tidak berpengaruh pada hasil. Perilaku yang dimaksudkan adalah mempertajam mask pada pengaturan yang lebih tinggi.

bawaan 28

Jumlah langkah inferensi yang dijalankan.

bawaan 1

Skala classifier-free guidance aktual yang diterapkan selama pembuatan.

bawaan 0.98

Kekuatan yang diterapkan selama pass resolusi rendah.

bawaan 0.95

Kekuatan yang diterapkan selama pass resolusi tinggi; hanya berlaku saat enable_hr_fix adalah True.

bawaan 0.5
bawaan 5

Kekuatan kepatuhan terhadap prompt untuk pemilihan gambar, dinyatakan sebagai CFG (Classifier Free Guidance).

Seed untuk gambar yang dapat direproduksi: prompt dan seed identik menghasilkan gambar identik jika versi model tidak berubah.

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

Jalankan permintaan ini

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang IC-Light-v2 for Image Relighting

Menerima gambar sumber (`image_url`) dan `prompt` yang menjelaskan pencahayaan serta latar yang diinginkan. `initial_latent` dapat menetapkan arah cahaya (Left, Right, Top, Bottom), dan `mask_image_url` opsional dapat mengarahkan hasil. Menyediakan `enable_hr_fix` untuk proses resolusi tinggi, 1-4 output melalui `num_images`, serta output jpeg atau png.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
promptwajib
Tipestring
Prompt yang memandu pembuatan gambar.
negative_promptopsional
Tipestring
Bawaan
Prompt negatif yang menentukan konten gambar yang tidak diinginkan.
image_urlwajib image
Tipeurl · image
URL yang mengarah ke gambar yang akan diberi pencahayaan ulang.
mask_image_urlopsional
Tipeurl · image
URL mask untuk gambar conditioning ic-light.
background_thresholdopsional
Tipenumber
Bawaan0.67
0,01 – 1
Ambang penghapusan latar belakang yang sudah deprecated dan saat ini tidak berpengaruh pada hasil. Perilaku yang dimaksudkan adalah mempertajam mask pada pengaturan yang lebih tinggi.
image_sizeopsional
Tipeobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensi gambar yang dihasilkan.
num_inference_stepsopsional
Tipeinteger
Bawaan28
1 – 50
Jumlah langkah inferensi yang dijalankan.
seedopsional
Tipeinteger | null
Seed untuk gambar yang dapat direproduksi: prompt dan seed identik menghasilkan gambar identik jika versi model tidak berubah.
initial_latentopsional
Tipeenum
BawaanNone
NoneLeftRightTopBottom
Kondisi pencahayaan yang diberikan kepada model.
enable_hr_fixopsional
Tipeboolean
Bawaanfalse
Mengaktifkan HR fix.
num_imagesopsional num_outputs
Tipeinteger
Bawaan1
1 – 4
Jumlah gambar yang diminta untuk dibuat.
cfgopsional
Tipenumber
Bawaan1
0,01 – 5
Skala classifier-free guidance aktual yang diterapkan selama pembuatan.
lowres_denoiseopsional
Tipenumber
Bawaan0.98
0,01 – 1
Kekuatan yang diterapkan selama pass resolusi rendah.
highres_denoiseopsional
Tipenumber
Bawaan0.95
0,01 – 1
Kekuatan yang diterapkan selama pass resolusi tinggi; hanya berlaku saat enable_hr_fix adalah True.
hr_downscaleopsional
Tipenumber
Bawaan0.5
0,01 – 1
guidance_scaleopsional
Tipenumber
Bawaan5
0 – 20
Kekuatan kepatuhan terhadap prompt untuk pemilihan gambar, dinyatakan sebagai CFG (Classifier Free Guidance).
enable_safety_checkeropsional
Tipeboolean
Bawaantrue
Sakelar pemeriksaan keamanan yang saat dinonaktifkan memerlukan otorisasi akun. Tanpa otorisasi tersebut, setiap permintaan diperiksa terlepas dari pengaturannya; true mengaktifkan pemeriksa.
output_formatopsional
Tipeenum
Bawaanjpeg
jpegpng
Format file untuk gambar hasil.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. 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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
images
array of object {url, width, height, content_type}Informasi file untuk gambar yang dihasilkan.
timings
object
seed
integerSeed pembuatan gambar, termasuk nilai yang dipilih secara acak jika input tidak menyertakan seed; jika tidak, nilai yang diberikan akan diulang.
has_nsfw_concepts
array of booleanMenunjukkan apakah konsep NSFW muncul dalam gambar yang dihasilkan.
prompt
stringPrompt yang digunakan selama pembuatan gambar.

Untuk agen AI: halaman ini dalam Markdown tersedia di https://doitong.com/id/developers/models/iclight-v2.md. Semua model dan panduan: https://doitong.com/developers/llms.txt