Bỏ qua đến nội dung

IC-Light-v2 for Image Relighting

Tích hợp

Id mô hình iclight-v2
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Yêu cầu này: ≈0,40 $ 400 tín dụng API · ≈ 42,19 ₽ Chạy trên trang này

Lấy khóa API
Open model Chỉnh sửa hình ảnh #relighting#editing

Chiếu sáng lại ảnh và thay đổi nền theo mô tả văn bản

Open model · Hình ảnh

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc

Lời nhắc định hướng việc tạo sinh hình ảnh.

•bắt buộc image_url
Thả tệp hoặc

URL trỏ đến hình ảnh sẽ được chiếu sáng lại.

image_size

Kích thước hình ảnh được tạo.

num_images mặc định 1

Số lượng hình ảnh yêu cầu tạo sinh.

Nâng cao 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
mặc định

Lời nhắc phủ định chỉ định nội dung hình ảnh không mong muốn.

Thả tệp hoặc

URL mặt nạ cho hình ảnh điều kiện hóa ic-light.

initial_latent mặc định None

Điều kiện ánh sáng được cung cấp cho mô hình.

output_format mặc định jpeg

Định dạng tệp của hình ảnh kết quả.

mặc định 0.67

Ngưỡng loại bỏ nền đã lỗi thời, hiện không ảnh hưởng đến kết quả. Hành vi dự kiến của tham số này là làm sắc nét mặt nạ ở các thiết lập cao hơn.

mặc định 28

Số bước suy luận cần chạy.

mặc định 1

Hệ số hướng dẫn không dùng bộ phân loại thực tế được áp dụng trong quá trình tạo sinh.

mặc định 0.98

Mức độ tác động trong lượt xử lý độ phân giải thấp.

mặc định 0.95

Mức độ tác động trong lượt xử lý độ phân giải cao; chỉ có hiệu lực khi enable_hr_fix là True.

mặc định 0.5
mặc định 5

Mức độ tuân thủ lời nhắc khi chọn hình ảnh, được biểu thị bằng CFG (Classifier Free Guidance).

Seed cho hình ảnh có thể tái tạo: lời nhắc và seed giống hệt nhau sẽ tạo ra hình ảnh giống hệt khi phiên bản mô hình không đổi.

POST /run/iclight-v2?wait=20 báo giá → 0,40 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về IC-Light-v2 for Image Relighting

Nhận ảnh nguồn (`image_url`) và `prompt` mô tả ánh sáng, nền mong muốn. `initial_latent` có thể đặt hướng sáng (Left, Right, Top, Bottom), còn `mask_image_url` tùy chọn dùng để điều kiện hóa kết quả. Có `enable_hr_fix` cho bước độ phân giải cao, 1-4 đầu ra qua `num_images` và đầu ra jpeg hoặc png.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
promptbắt buộc
Kiểustring
Lời nhắc định hướng việc tạo sinh hình ảnh.
negative_prompttùy chọn
Kiểustring
Mặc định
Lời nhắc phủ định chỉ định nội dung hình ảnh không mong muốn.
image_urlbắt buộc image
Kiểuurl · image
URL trỏ đến hình ảnh sẽ được chiếu sáng lại.
mask_image_urltùy chọn
Kiểuurl · image
URL mặt nạ cho hình ảnh điều kiện hóa ic-light.
background_thresholdtùy chọn
Kiểunumber
Mặc định0.67
0,01 – 1
Ngưỡng loại bỏ nền đã lỗi thời, hiện không ảnh hưởng đến kết quả. Hành vi dự kiến của tham số này là làm sắc nét mặt nạ ở các thiết lập cao hơn.
image_sizetùy chọn
Kiểuobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Kích thước hình ảnh được tạo.
num_inference_stepstùy chọn
Kiểuinteger
Mặc định28
1 – 50
Số bước suy luận cần chạy.
seedtùy chọn
Kiểuinteger | null
Seed cho hình ảnh có thể tái tạo: lời nhắc và seed giống hệt nhau sẽ tạo ra hình ảnh giống hệt khi phiên bản mô hình không đổi.
initial_latenttùy chọn
Kiểuenum
Mặc địnhNone
NoneLeftRightTopBottom
Điều kiện ánh sáng được cung cấp cho mô hình.
enable_hr_fixtùy chọn
Kiểuboolean
Mặc địnhfalse
Bật HR fix.
num_imagestùy chọn num_outputs
Kiểuinteger
Mặc định1
1 – 4
Số lượng hình ảnh yêu cầu tạo sinh.
cfgtùy chọn
Kiểunumber
Mặc định1
0,01 – 5
Hệ số hướng dẫn không dùng bộ phân loại thực tế được áp dụng trong quá trình tạo sinh.
lowres_denoisetùy chọn
Kiểunumber
Mặc định0.98
0,01 – 1
Mức độ tác động trong lượt xử lý độ phân giải thấp.
highres_denoisetùy chọn
Kiểunumber
Mặc định0.95
0,01 – 1
Mức độ tác động trong lượt xử lý độ phân giải cao; chỉ có hiệu lực khi enable_hr_fix là True.
hr_downscaletùy chọn
Kiểunumber
Mặc định0.5
0,01 – 1
guidance_scaletùy chọn
Kiểunumber
Mặc định5
0 – 20
Mức độ tuân thủ lời nhắc khi chọn hình ảnh, được biểu thị bằng CFG (Classifier Free Guidance).
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Công tắc kiểm tra an toàn, trong đó trạng thái tắt yêu cầu ủy quyền tài khoản. Nếu không có ủy quyền, mọi yêu cầu đều được kiểm tra bất kể cài đặt; true bật trình kiểm tra.
output_formattùy chọn
Kiểuenum
Mặc địnhjpeg
jpegpng
Định dạng tệp của hình ảnh kết quả.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
images
array of object {url, width, height, content_type}Thông tin tệp của các hình ảnh được tạo.
timings
object
seed
integerSeed tạo sinh hình ảnh, bao gồm giá trị được chọn ngẫu nhiên nếu đầu vào không cung cấp seed; nếu không, lặp lại giá trị đã cung cấp.
has_nsfw_concepts
array of booleanCho biết các khái niệm NSFW có xuất hiện trong hình ảnh được tạo sinh hay không.
prompt
stringLời nhắc được sử dụng trong quá trình tạo sinh hình ảnh.

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/iclight-v2.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt