Build a website with Next.jsBuild a Discord bot with PythonBuild an app with SwiftUIPush your own modelPush a Diffusers modelPush a Transformers modelPush a model using GitHub ActionsDeploy a custom modelFine-tune a language modelGet a GPU machine
Home / Guides / Instant id

Run InstantID with an API


With Replicate, you can run InstantID in the cloud with one line of code.

Usage Tips

  • For higher similarity, increase the weight of controlnet_conditioning_scale (IdentityNet) and ip_adapter_scale (Adapter).
  • For over-saturation, decrease the ip_adapter_scale. If not work, decrease controlnet_conditioning_scale.
  • For higher text control ability, decrease ip_adapter_scale.
  • For specific styles, choose corresponding base model makes differences.
  • We have not supported multi-person yet, will only use the largest face as reference pose.

Run InstantID with JavaScript

You can run InstantID with our official JavaScript client:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<your-api-token>

Import and set up the client:

import Replicate from "replicate";
 
const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run zsxkib/instant-id using Replicate’s API:

const output = await replicate.run(
  "zsxkib/instant-id:latest",
  {
    input: {
		"image": "https://replicate.delivery/pbxt/KIIutO7jIleskKaWebhvurgBUlHR6M6KN7KHaMMWSt4OnVrF/musk_resize.jpeg",
		"width": 640,
		"height": 640,
		"prompt": "analog film photo of a man. faded film, desaturated, 35mm photo, grainy, vignette, vintage, Kodachrome, Lomography, stained, highly detailed, found footage, masterpiece, best quality",
		"sdxl_weights": "protovision-xl-high-fidel",
		"guidance_scale": 5,
		"negative_prompt": "(lowres, low quality, worst quality:1.2), (text:1.2), watermark, painting, drawing, illustration, glitch, deformed, mutated, cross-eyed, ugly, disfigured (lowres, low quality, worst quality:1.2), (text:1.2), watermark, painting, drawing, illustration, glitch,deformed, mutated, cross-eyed, ugly, disfigured",
		"ip_adapter_scale": 0.8,
		"num_inference_steps": 30,
		"disable_safety_checker": False,
		"controlnet_conditioning_scale": 0.8
    }
  }
);
console.log(output);

Note that InstandID takes an image as input. You can provide URLs or base 64 strings as values for the image.

To learn more, take a look at the guide on getting started with Node.js.

Run InstantID with Python

You can run InstantID with our official Python client:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<your-api-token>

Run zsxkib/instant-id using Replicate’s API:

import replicate
 
output = replicate.run(
    "zsxkib/instant-id:latest",
    input={
		"image": "https://replicate.delivery/pbxt/KIIutO7jIleskKaWebhvurgBUlHR6M6KN7KHaMMWSt4OnVrF/musk_resize.jpeg",
		"width": 640,
		"height": 640,
		"prompt": "analog film photo of a man. faded film, desaturated, 35mm photo, grainy, vignette, vintage, Kodachrome, Lomography, stained, highly detailed, found footage, masterpiece, best quality",
		"sdxl_weights": "protovision-xl-high-fidel",
		"guidance_scale": 5,
		"negative_prompt": "(lowres, low quality, worst quality:1.2), (text:1.2), watermark, painting, drawing, illustration, glitch, deformed, mutated, cross-eyed, ugly, disfigured (lowres, low quality, worst quality:1.2), (text:1.2), watermark, painting, drawing, illustration, glitch,deformed, mutated, cross-eyed, ugly, disfigured",
		"ip_adapter_scale": 0.8,
		"num_inference_steps": 30,
		"disable_safety_checker": False,
		"controlnet_conditioning_scale": 0.8
    }
)
print(output)

Note that InstandID takes an image as input. You can provide URLs or base 64 strings as values for the image.

To learn more, take a look at the guide on getting started with Python.

Run InstantID with cURL

You can call the HTTP API directly with tools like cURL:

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<your-api-token>

Run zsxkib/instant-id using Replicate’s API:

curl -s -X POST \
  -H "Authorization: Token $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d $'{
    "version": "c98b2e7a196828d00955767813b81fc05c5c9b294c670c6d147d545fed4ceecf",
    "input": {
		"image": "https://replicate.delivery/pbxt/KIIutO7jIleskKaWebhvurgBUlHR6M6KN7KHaMMWSt4OnVrF/musk_resize.jpeg",
		"width": 640,
		"height": 640,
		"prompt": "analog film photo of a man. faded film, desaturated, 35mm photo, grainy, vignette, vintage, Kodachrome, Lomography, stained, highly detailed, found footage, masterpiece, best quality",
		"sdxl_weights": "protovision-xl-high-fidel",
		"guidance_scale": 5,
		"negative_prompt": "(lowres, low quality, worst quality:1.2), (text:1.2), watermark, painting, drawing, illustration, glitch, deformed, mutated, cross-eyed, ugly, disfigured (lowres, low quality, worst quality:1.2), (text:1.2), watermark, painting, drawing, illustration, glitch,deformed, mutated, cross-eyed, ugly, disfigured",
		"ip_adapter_scale": 0.8,
		"num_inference_steps": 30,
		"disable_safety_checker": False,
		"controlnet_conditioning_scale": 0.8
    }
  }' \
  https://api.replicate.com/v1/models/zsxkib/instant-id/predictions

Note that InstandID takes an image as input. You can provide URLs or base 64 strings as values for the image.

To learn more, take a look at Replicate’s HTTP API reference docs.

You can also run InstantID using other Replicate client libraries for Golang, Swift, Elixir, and others

Keep up to speed