Ir al contenido

IC-Light-v2 for Image Relighting

Integrar

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

Esta solicitud: ≈0,40 $ 400 créditos de API Ejecutar en esta página

Obtener clave de API
Open model Edición de imágenes #relighting#editing

Cambia la iluminación de una foto y su fondo según una descripción de texto

Open model · Imagen

Tu primer resultado aparecerá aquí

Crea una solicitud a continuación y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, conservadas para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan al modificarlos.

•obligatorio

Prompt que guía la generación de imágenes.

•obligatorio image_url
Suelta un archivo o

URL que apunta a la imagen que se iluminará de nuevo.

image_size

Dimensiones de la imagen generada.

num_images predeterminado 1

Número de imágenes solicitado para la generación.

Avanzado 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
predeterminado

Prompt negativo que especifica el contenido de imagen no deseado.

Suelta un archivo o

URL de la máscara para la imagen de condicionamiento de ic-light.

initial_latent predeterminado None

Condiciones de iluminación proporcionadas al modelo.

output_format predeterminado jpeg

Formato de archivo de la imagen resultante.

predeterminado 0.67

Umbral obsoleto de eliminación del fondo sin efecto actual en los resultados. Su comportamiento previsto es definir máscaras más nítidas con valores altos.

predeterminado 28

Número de pasos de inferencia que se deben ejecutar.

predeterminado 1

Escala real de guidance sin clasificador aplicada durante la generación.

predeterminado 0.98

Intensidad aplicada durante el paso de baja resolución.

predeterminado 0.95

Intensidad aplicada durante el paso de alta resolución; solo tiene efecto cuando enable_hr_fix es True.

predeterminado 0.5
predeterminado 5

Intensidad de seguimiento del prompt para la selección de imágenes, expresada como CFG (Classifier Free Guidance).

Semilla para obtener imágenes reproducibles: un prompt y una semilla idénticos producen una imagen idéntica cuando la versión del modelo no cambia.

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

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y solo se guarda en localStorage si marcas Recordar. Obtener una clave de API

Acerca de IC-Light-v2 for Image Relighting

Recibe una imagen de origen (`image_url`) y un `prompt` que describe la iluminación y el fondo deseados. `initial_latent` puede establecer la dirección de la luz (Left, Right, Top, Bottom) y un `mask_image_url` opcional condiciona el resultado. Ofrece `enable_hr_fix` para un paso de alta resolución, de 1 a 4 salidas mediante `num_images` y salida jpeg o png.

Parámetros

Envía el nombre canónico o el nombre nativo, pero no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
promptobligatorio
Tipostring
Prompt que guía la generación de imágenes.
negative_promptopcional
Tipostring
Predeterminado
Prompt negativo que especifica el contenido de imagen no deseado.
image_urlobligatorio image
Tipourl · image
URL que apunta a la imagen que se iluminará de nuevo.
mask_image_urlopcional
Tipourl · image
URL de la máscara para la imagen de condicionamiento de ic-light.
background_thresholdopcional
Tiponumber
Predeterminado0.67
0,01 – 1
Umbral obsoleto de eliminación del fondo sin efecto actual en los resultados. Su comportamiento previsto es definir máscaras más nítidas con valores altos.
image_sizeopcional
Tipoobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensiones de la imagen generada.
num_inference_stepsopcional
Tipointeger
Predeterminado28
1 – 50
Número de pasos de inferencia que se deben ejecutar.
seedopcional
Tipointeger | null
Semilla para obtener imágenes reproducibles: un prompt y una semilla idénticos producen una imagen idéntica cuando la versión del modelo no cambia.
initial_latentopcional
Tipoenum
PredeterminadoNone
NoneLeftRightTopBottom
Condiciones de iluminación proporcionadas al modelo.
enable_hr_fixopcional
Tipoboolean
Predeterminadofalse
Activa HR fix.
num_imagesopcional num_outputs
Tipointeger
Predeterminado1
1 – 4
Número de imágenes solicitado para la generación.
cfgopcional
Tiponumber
Predeterminado1
0,01 – 5
Escala real de guidance sin clasificador aplicada durante la generación.
lowres_denoiseopcional
Tiponumber
Predeterminado0.98
0,01 – 1
Intensidad aplicada durante el paso de baja resolución.
highres_denoiseopcional
Tiponumber
Predeterminado0.95
0,01 – 1
Intensidad aplicada durante el paso de alta resolución; solo tiene efecto cuando enable_hr_fix es True.
hr_downscaleopcional
Tiponumber
Predeterminado0.5
0,01 – 1
guidance_scaleopcional
Tiponumber
Predeterminado5
0 – 20
Intensidad de seguimiento del prompt para la selección de imágenes, expresada como CFG (Classifier Free Guidance).
enable_safety_checkeropcional
Tipoboolean
Predeterminadotrue
Interruptor de comprobación de seguridad cuyo estado desactivado requiere autorización de la cuenta. Sin esa autorización, se comprueba cada solicitud independientemente del ajuste; true activa el comprobador.
output_formatopcional
Tipoenum
Predeterminadojpeg
jpegpng
Formato de archivo de la imagen resultante.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una subida. Archivos

Salida

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"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (con pago por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para vídeo y audio. output es el objeto de resultado propio del modelo.
Campos de salida
images
array of object {url, width, height, content_type}Información de los archivos de las imágenes generadas.
timings
object
seed
integerSemilla de generación de imágenes, incluido el valor elegido aleatoriamente si la entrada no proporcionó una semilla; de lo contrario, repite el valor proporcionado.
has_nsfw_concepts
array of booleanIndica si aparecen conceptos NSFW en las imágenes generadas.
prompt
stringPrompt utilizado durante la generación de imágenes.

Para agentes de IA: esta página en Markdown está en https://doitong.com/es-ES/developers/models/iclight-v2.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt