## Basic tool info Tool name: wiro/ic-light-background Tool description: More Lighting! IC-Light is used to manipulate the illumination of images using a background-conditioned model. Tool cover: https://cdn.wiro.ai/uploads/models/wiro-ic-light-bg-cover.png Tool categories: - tool - image-to-image - checkpoint-folder - compare-portrait Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/wiro/ic-light-background Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: selectedModel label: select-model help: select-model-help type: select default: "1" options: - value: "632" label: ItsJayQz/GTA5_Artwork_Diffusion description: This model was trained on the loading screens, gta storymode, and gta online DLCs artworks. Which includes characters, background, chop, and some objects. The model can do people and portrait pretty easily, as well as cars, and houses. triggerwords: ["gtav style"] generatesettings: [] - value: "482" label: SG161222/Realistic Vision v6.0 B1 noVAE description: An instruction-based image editing model triggerwords: [] generatesettings: [] - value: "481" label: SG161222/Realistic Vision v5.1 noVAE description: An instruction-based image editing model triggerwords: [] generatesettings: [] - value: "55" label: Yntec/CinemaEros description: This model is commonly used for photoreal women, pictures, portraits, candids, fashion shows, softcore, and erotic nudes. triggerwords: [] generatesettings: [] - value: "54" label: Lykon/dreamshaper-8 description: DreamShaper started as a model to have an alternative to MidJourney in the open source world. triggerwords: [] generatesettings: [] - value: "53" label: Falah/fashion-model description: Generate images of fashionable clothes for women based on SD 1.5. triggerwords: [] generatesettings: [] - value: "52" label: Lykon/NeverEnding-Dream description: This model is great at generating cosplay images, generating anime pictures, generating good-looking people, generating realistic animals, generating images using booru-like tags. triggerwords: [] generatesettings: [] - value: "51" label: 22h/vintedois-diffusion-v0-2 description: This model was trained on a large amount of high quality images with simple prompts to generate beautiful images without a lot of prompt engineering. triggerwords: ["estilovintedois"] generatesettings: [] - value: "50" label: Envvi/Inkpunk-Diffusion description: Finetuned Stable Diffusion model trained on dreambooth. Vaguely inspired by Gorillaz, FLCL, and Yoji Shinkawa. triggerwords: ["nvinkpunk"] generatesettings: [] - value: "49" label: wavymulder/modelshoot description: Modelshoot is trained on a diverse set of photographs of people. The goal was to create a model focused on full to medium body shots, with cool clothing and a fashion-shoot aesthetic. triggerwords: ["modelshoot style"] generatesettings: [] - value: "45" label: SG161222/Realistic Vision v2.0 description: An instruction-based image editing model triggerwords: ["RAW photo","(high detailed skin:1.2)","dslr","soft lighting","Fujifilm XT3"] generatesettings: [] - value: "7" label: dallinmackay/Van Gogh Diffusion description: A fine-tuned Stable Diffusion model (based on v1.5) trained on screenshots from the film Loving Vincent. triggerwords: ["lvngvncnt"] generatesettings: [] - value: "6" label: wavymulder/portraitplus description: A dreambooth model trained on a diverse set of close to medium range portraits of people. triggerwords: ["portrait+ style"] generatesettings: [] - value: "5" label: prompthero/openjourney-v4 description: A text-to-image diffusion model that makes AI art images in the style of Midjourney. triggerwords: [] generatesettings: [] - value: "4" label: plasmo/vox2 description: 3D pixel art, Jak's Voxel-ish Image Pack v.1.2 for Stable Diffusion triggerwords: ["voxel-ish"] generatesettings: [] - value: "3" label: stabilityai/stable-diffusion-2-1 description: Model is fine-tuned from stable-diffusion-2 with an additional 55k steps on the same dataset, and then fine-tuned for another 155k extra steps. triggerwords: [] generatesettings: [] - value: "2" label: stable-diffusion-v1-5/stable-diffusion-v1-5 description: A latent text-to-image diffusion model capable of generating photo-realistic images given any text input,initialized with the weights of the Stable-Diffusion-v1-2 checkpoint. triggerwords: [] generatesettings: [] - value: "1" label: CompVis/stable-diffusion-v1-4 description: A latent text-to-image diffusion model capable of generating photo-realistic images given any text input. triggerwords: [] generatesettings: [] - name: selectedModelPrivate label: select-model-private help: select-model-private-help type: select default: "" options: - name: inputImageUrl label: background-image-url help: background-imagurl-help type: text default: - name: inputImage2Url label: foreground-image-url help: foreground-imagurl-help type: text default: - name: prompt label: prompt help: prompt-help type: textarea default: a woman - name: negativePrompt label: negativeprompt help: negativeprompt-help type: textarea default: bad quality - name: samples label: numberofoutputs help: numberofoutputs-help type: number default: 1 - name: steps label: inferencesteps help: inferencesteps-help type: number default: 30 - name: scale label: guidancescale help: guidancescale-help type: float default: 2.0 - name: highres_scale label: highres-scale help: highres-scale-help type: float default: 1.5 - name: highres_denoise label: highres-denoise help: highres-denoise-help type: float default: 0.5 - name: seed label: seed help: seed-help type: text default: 123456 - name: bg_source label: bg-source help: bg-source-help type: select default: Use Background Image options: - value: "Use Background Image" label: Use Background Image - value: "Use Flipped Background Image" label: Use Flipped Background Image ## Tool Parameter Inspires: - prompt: handsome man, cinematic lighting - prompt: beautiful woman, natural lighting - prompt: beautiful woman, neon punk lighting, cyberpunk - prompt: handsome man, neon punk lighting, cyberpunk ## Integration Header Prepare ```bash # Sign up Wiro dashboard and create project export YOUR_API_KEY="{{useSelectedProjectAPIKey}}"; export YOUR_API_SECRET="XXXXXXXXX"; # unix time or any random integer value export NONCE=$(date +%s); # hmac-SHA256 (YOUR_API_SECRET+Nonce) with YOUR_API_KEY export SIGNATURE="$(echo -n "${YOUR_API_SECRET}${NONCE}" | openssl dgst -sha256 -hmac "${YOUR_API_KEY}")"; ``` ## Run Command - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Run/wiro/ic-light-background" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "selectedModel": "", "selectedModelPrivate": "", "inputImageUrl": "bg-img2.png", "inputImage2Url": "ic-light.png", "prompt": "a woman", "negativePrompt": "bad quality", "samples": 1, "steps": 30, "scale": "2.0", "highres_scale": "1.5", "highres_denoise": "0.5", "seed": "123456", "bg_source": "Use Background Image", "callbackUrl": "You can provide a callback URL; Wiro will send a POST request to it when the task is completed." }'; ``` ## Run Command - Response ```json { "errors": [], "taskid": "2221", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "result": true } ``` ## Get Task Detail - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Task/Detail" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "tasktoken": 'eDcCm5yyUfIvMFspTwww49OUfgXkQt', }'; ``` ## Get Task Detail - Response ```json { "total": "1", "errors": [], "tasklist": [ { "id": "2221", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "parameters": {}, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_postprocess_end", "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Task Status Information This section defines the possible task status values returned by the API when polling for task completion. ### Completed Task Statuses (Polling can stop) These indicate that the task has reached a terminal state — either success or failure. Once any of these is received, polling should stop. - task_postprocess_end : Task completed successfully and post-processing is done. - task_cancel : Task was cancelled by the user or system. ### Running Task Statuses (Continue polling) These statuses indicate that the task is still in progress. Polling should continue if one of these is returned. - task_queue : Task is waiting in the queue. - task_accept : Task has been accepted for processing. - task_assign : Task is being assigned to a worker. - task_preprocess_start : Preprocessing is starting. - task_preprocess_end : Preprocessing is complete. - task_start : Task execution has started. - task_output : Output is being generated.