## Basic tool info

Tool name: wiro/instant-id-controlnet-lora
Tool description: InstantID is a method to achieve ID-preserving generation with only single image. Alternatively, it can take an image to control the pose of the output.
Tool cover: https://cdn.wiro.ai/uploads/models/wiro-instant-id-pose-cover.png
Tool categories:
  - tool
  - image-to-image
  - persistent


Run Task Endpoint (POST):
https://api.wiro.ai/v1/Run/wiro/instant-id-controlnet-lora

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: 
    options:
      - value: "850"
        label: Lykon/DreamShaper-XL
        description: DreamShaper XL
        triggerwords: []
        generatesettings: []

      - value: "984"
        label: socalguitarist/NightVisionXL
        description: NightVisionXL
        triggerwords: []
        generatesettings: []

      - value: "964"
        label: StableDiffusionVN/SDVN8-ArtXL
        description: SDVN8-ArtXL
 
        triggerwords: ["ghibli","sticker design","portrait art style","illustrator","horror style","anime style"]
        generatesettings: []

      - value: "1107"
        label: advokat/5DN-Hyperdetailed
        description: 5DN Hyperdetailed
        triggerwords: []
        generatesettings: []

      - value: "555"
        label: SG161222/RealVisXL_V3_0
        description: An instruction-based image editing model SDXL.
        triggerwords: []
        generatesettings: []

  - name: selectedModelPrivate
    label: select-model-private
    help: select-model-private-help
    type: select
    default: 
    options:


  - name: selectedLoraModel
    label: select-lora-model
    help: select-lora-model-help
    type: select
    default: 
    options:
      - value: "429"
        label: viktor245/Valorant Art Style v1.0
        description: A text-to-image model with Stable Diffusion XL and Lora XL. Generates Valorant style image
        triggerwords: ["valorant art style"]
        generatesettings: [{"type":"float","template":"<lora:Valorant-Art-Style-v1.0:{{value}}>","id":"Valorant-Art-Style-v1.0","placeholder":"Valorant-Art-Style-v1.0 scale","label":"Valorant-Art-Style-v1.0 scale","minvalue":"0.00","maxvalue":"1","value":"1.0","defaultvalue":"1.0","incrementby":"0.1","options":[],"note":""}]

      - value: "399"
        label: chillpixel/Blacklight Makeup v2.0
        description: A text-to-image model with Stable Diffusion XL and Lora XL. Blacklight makeup is a mesmerizing art style that I have come to enjoy for its creativity and boldness.
        triggerwords: ["blacklight makeup"]
        generatesettings: [{"type":"float","template":"<lora:Blacklight-Makeup-v2.0:{{value}}>","id":"Blacklight-Makeup-v2.0","placeholder":"Blacklight-Makeup-v2.0 scale","label":"Blacklight-Makeup-v2.0 scale","minvalue":"0.00","maxvalue":"1","value":"1.0","defaultvalue":"1.0","incrementby":"0.1","options":[],"note":""}]

      - value: "541"
        label: jjhuang/JJs Interior Style - Nordic v1.0 - LoRA XL
        description: A text-to-image model with Stable Diffusion XL and Lora XL. The LoRA has a high capacity to generate interior design!
        triggerwords: ["Nordic Style"]
        generatesettings: [{"type":"float","template":"<lora:JJs-Interior-Style-Nordic-v1.0-LoRA-XL:{{value}}>","id":"JJs-Interior-Style-Nordic-v1.0-LoRA-XL","placeholder":"JJs-Interior-Style-Nordic-v1.0-LoRA-XL scale","label":"JJs-Interior-Style-Nordic-v1.0-LoRA-XL scale","minvalue":"0.00","maxvalue":"1","value":"0.5","defaultvalue":"0.5","incrementby":"0.1","options":[],"note":""}]

      - value: "369"
        label: getphat/Salvador Dali Style v1.0
        description: Salvador Dali art style lora for SDXL 1.0. Salvador Dali is one of the most famous surrealist painters and now you can generate art similar to his signature style within your own Stable Diffusion workflow.
        triggerwords: ["d4lixl"]
        generatesettings: [{"type":"float","template":"<lora:Salvador-Dali-Style-v1.0:{{value}}>","id":"Salvador-Dali-Style-v1.0","placeholder":"Salvador-Dali-Style-v1.0 scale","label":"Salvador-Dali-Style-v1.0 scale","minvalue":"0.00","maxvalue":"1","value":"1.0","defaultvalue":"1.0","incrementby":"0.1","options":[],"note":""}]

      - value: "365"
        label: Faeia/Chalk Dust Style v1.0
        description: A text-to-image model with Stable Diffusion XL and Lora XL. This LoRA gives a fun colorful chalk dust/cloud effect on images.
        triggerwords: ["chalkdust"]
        generatesettings: [{"type":"float","template":"<lora:Chalk-Dust-Style-v1.0:{{value}}>","id":"Chalk-Dust-Style-v1.0","placeholder":"Chalk-Dust-Style-v1.0 scale","label":"Chalk-Dust-Style-v1.0 scale","minvalue":"0.00","maxvalue":"1","value":"1.0","defaultvalue":"1.0","incrementby":"0.1","options":[],"note":""}]

  - name: selectedLoraModelPrivate
    label: select-lora-model-private
    help: select-lora-model-private-help
    type: select
    default: 
    options:


  - name: selectedLoraModelPrivateUrl
    label: LoRA Model Url
    help: You can provide a direct URL to a LoRA model (.safetensors). We’ll apply it during generation. You can also use links from platforms like Google Drive, AWS S3, or any publicly accessible file host.
    type: text
    default: 

  - name: inputImageUrl
    label: input-image-url
    help: input-image-url-help
    type: text
    default: 

  - name: selectedControlnetModel
    label: select-controlnet-model
    help: select-controlnet-model-help
    type: multiselect
    default: 
    options:
      - value: "458"
        label: thibaud/controlnet-openpose-sdxl-1.0
        description: SDXL ControlNet is a neural network structure to control diffusion models by adding extra conditions.
        triggerwords: []
        generatesettings: [{"type":"float","template":"<ct:open_pose:controlnet-openpose-sdxl-1.0:{{value}}>","id":"controlnet-openpose-sdxl-1.0","placeholder":"controlnet-openpose-sdxl-1.0 scale","label":"controlnet-openpose-sdxl-1.0 scale","minvalue":"0.00","maxvalue":"1","value":"1.0","defaultvalue":"1.0","incrementby":"0.1","options":[],"note":""}]

      - value: "455"
        label: diffusers/controlnet-depth-sdxl-1.0
        description: SDXL ControlNet is a neural network structure to control diffusion models by adding extra conditions.
        triggerwords: []
        generatesettings: [{"type":"float","template":"<ct:depth:controlnet-depth-sdxl-1.0:{{value}}>","id":"controlnet-depth-sdxl-1.0","placeholder":"controlnet-depth-sdxl-1.0 scale","label":"controlnet-depth-sdxl-1.0 scale","minvalue":"0.00","maxvalue":"1","value":"1.0","defaultvalue":"1.0","incrementby":"0.1","options":[],"note":""}]

      - value: "454"
        label: diffusers/controlnet-canny-sdxl-1.0
        description: SDXL ControlNet is a neural network structure to control diffusion models by adding extra conditions.
        triggerwords: []
        generatesettings: [{"type":"float","template":"<ct:canny:controlnet-canny-sdxl-1.0:{{value}}>","id":"controlnet-canny-sdxl-1.0","placeholder":"controlnet-canny-sdxl-1.0 scale","label":"controlnet-canny-sdxl-1.0 scale","minvalue":"0.00","maxvalue":"1","value":"1.0","defaultvalue":"1.0","incrementby":"0.1","options":[],"note":""}]

  - name: prompt
    label: prompt
    help: prompt-help
    type: textarea
    default: olympic athlete, standing, wearing olympics uniform, Paris background, photorealistic, realistic, embodies the spirit of victory, captured by the official Olympic Games photographer 2024, the image is framed through photographer Steve McCurry, 2015, used a classic 50mm lens and illuminated by the brilliance of stadium floodlights, realistic

  - name: negativePrompt
    label: negativeprompt
    help: negativeprompt-help
    type: textarea
    default: (lowres, low quality, worst quality:1.2), (text:1.2), watermark, (frame:1.2), deformed, ugly, deformed eyes, blur, out of focus, blurry, mutation, mutated arms, deformed cat, deformed, photo, anthropomorphic cat, monochrome, photo, pet collar, gun, weapon, blue, 3d, drones, drone, buildings in background, green, nsfw

  - name: steps
    label: inferencesteps
    help: inferencesteps-help
    type: number
    default: 20

  - name: scale
    label: guidancescale
    help: guidancescale-help
    type: float
    default: 5.0

  - name: ip_adapter_scale
    label: ip_adapter_scale
    help: guidancescale-help
    type: float
    default: 0.8

  - name: samples
    label: samples
    help: guidancescale-help
    type: number
    default: 1

  - name: seed
    label: seed
    help: seed-help
    type: text
    default: 3572004920

  - name: scheduler
    label: scheduler
    help: scheduler-help
    type: select
    default: DDIMScheduler
    options:
      - value: "FlowMatchEulerDiscreteScheduler"
        label: FlowMatchEulerDiscreteScheduler

      - value: "EulerDiscreteScheduler"
        label: EulerDiscreteScheduler

      - value: "DDIMScheduler"
        label: DDIMScheduler

      - value: "LMSDiscreteScheduler"
        label: LMSDiscreteScheduler

      - value: "DPMSolverMultistepScheduler"
        label: DPMSolverMultistepScheduler

      - value: "EulerDiscreteScheduler"
        label: EulerDiscreteScheduler

      - value: "PNDMScheduler"
        label: PNDMScheduler

      - value: "DDPMScheduler"
        label: DDPMScheduler

      - value: "EulerAncestralDiscreteScheduler"
        label: EulerAncestralDiscreteScheduler



## 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/instant-id-controlnet-lora" 
-H "Content-Type: multipart/form-data" 
-H "x-api-key: ${YOUR_API_KEY}" 
-H "x-nonce: ${NONCE}" 
-H "x-signature: ${SIGNATURE}" 
-d '{
  "selectedModel": "",
  "selectedModelPrivate": "",
  "selectedLoraModel": [],
  "selectedLoraModelPrivateUrl": "",
  "inputImageUrl": "input-portrait-2.jpg",
  "selectedControlnetModel": [],
  "prompt": "olympic athlete, standing, wearing olympics uniform, Paris background, photorealistic, realistic, embodies the spirit of victory, captured by the official Olympic Games photographer 2024, the image is framed through photographer Steve McCurry, 2015, used a classic 50mm lens and illuminated by the brilliance of stadium floodlights, realistic",
  "negativePrompt": "(lowres, low quality, worst quality:1.2), (text:1.2), watermark, (frame:1.2), deformed, ugly, deformed eyes, blur, out of focus, blurry, mutation, mutated arms, deformed cat, deformed, photo, anthropomorphic cat, monochrome, photo, pet collar, gun, weapon, blue, 3d, drones, drone, buildings in background, green, nsfw",
  "steps": 20,
  "scale": "5.0",
  "ip_adapter_scale": "0.8",
  "samples": 1,
  "seed": "3572004920",
  "scheduler": "DDIMScheduler",
  "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.