ludocomito/flux-kuji – Run with an API on Replicate

ludocomito / flux-kuji

Warm

Public
48 runs
H100

Run with an API

Playground API Examples README Versions

Input

prompt

*string

Shift + Return to add a new line

Prompt for generated image. If you include the `trigger_word` used in the training process you are more likely to activate the trained object, style, or concept in the resulting image.

image

file

Input image for image to image or inpainting mode. If provided, aspect_ratio, width, and height inputs are ignored.

mask

file

Image mask for image inpainting mode. If provided, aspect_ratio, width, and height inputs are ignored.

aspect_ratio

string

Aspect ratio for the generated image. If custom is selected, uses height and width below & will run in bf16 mode

Default: "1:1"

height

integer

(minimum: 256, maximum: 1440)

Height of generated image. Only works if `aspect_ratio` is set to custom. Will be rounded to nearest multiple of 16. Incompatible with fast generation

width

integer

(minimum: 256, maximum: 1440)

Width of generated image. Only works if `aspect_ratio` is set to custom. Will be rounded to nearest multiple of 16. Incompatible with fast generation

prompt_strength

number

(minimum: 0, maximum: 1)

Prompt strength when using img2img. 1.0 corresponds to full destruction of information in image

Default: 0.8

model

string

Which model to run inference with. The dev model performs best with around 28 inference steps but the schnell model only needs 4 steps.

Default: "dev"

num_outputs

integer

(minimum: 1, maximum: 4)

Number of outputs to generate

Default: 1

num_inference_steps

integer

(minimum: 1, maximum: 50)

Number of denoising steps. More steps can give more detailed images, but take longer.

Default: 28

guidance_scale

number

(minimum: 0, maximum: 10)

Guidance scale for the diffusion process. Lower values can give more realistic images. Good values to try are 2, 2.5, 3 and 3.5

Default: 3

seed

integer

Random seed. Set for reproducible generation

output_format

string

Format of the output images

Default: "webp"

output_quality

integer

(minimum: 0, maximum: 100)

Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs

Default: 80

disable_safety_checker

boolean

Disable safety checker for generated images.

Default: false

go_fast

boolean

Run faster predictions with model optimized for speed (currently fp8 quantized); disable to run in original bf16

Default: false

megapixels

string

Approximate number of megapixels for generated image

Default: "1"

lora_scale

number

(minimum: -1, maximum: 3)

Determines how strongly the main LoRA should be applied. Sane results between 0 and 1 for base inference. For go_fast we apply a 1.5x multiplier to this value; we've generally seen good performance when scaling the base value by that amount. You may still need to experiment to find the best value for your particular lora.

Default: 1

extra_lora

string

Shift + Return to add a new line

Load LoRA weights. Supports Replicate models in the format <owner>/<username> or <owner>/<username>/<version>, HuggingFace URLs in the format huggingface.co/<owner>/<model-name>, CivitAI URLs in the format civitai.com/models/<id>[/<model-name>], or arbitrary .safetensors URLs from the Internet. For example, 'fofr/flux-pixar-cars'

extra_lora_scale

number

(minimum: -1, maximum: 3)

Determines how strongly the extra LoRA should be applied. Sane results between 0 and 1 for base inference. For go_fast we apply a 1.5x multiplier to this value; we've generally seen good performance when scaling the base value by that amount. You may still need to experiment to find the best value for your particular lora.

Default: 1

Run this model in Node.js with one line of code:

npx create-replicate --model=ludocomito/flux-kuji

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";

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

Run ludocomito/flux-kuji using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const output = await replicate.run(
  "ludocomito/flux-kuji:5001e4db8ed2bce55e46f4323c8735bf571a66223a2be97d082c029852b2e036",
  {
    input: {
      model: "dev",
      prompt: "sunny beach in the style of KUJI",
      go_fast: false,
      lora_scale: 1,
      megapixels: "1",
      num_outputs: 1,
      aspect_ratio: "1:1",
      output_format: "webp",
      guidance_scale: 3.5,
      output_quality: 80,
      prompt_strength: 0.8,
      extra_lora_scale: 0.8,
      num_inference_steps: 42
    }
  }
);

// To access the file URL:
console.log(output[0].url()); //=> "http://example.com"

// To write the file to disk:
fs.writeFile("my-image.png", output[0]);

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

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run ludocomito/flux-kuji using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "ludocomito/flux-kuji:5001e4db8ed2bce55e46f4323c8735bf571a66223a2be97d082c029852b2e036",
    input={
        "model": "dev",
        "prompt": "sunny beach in the style of KUJI",
        "go_fast": False,
        "lora_scale": 1,
        "megapixels": "1",
        "num_outputs": 1,
        "aspect_ratio": "1:1",
        "output_format": "webp",
        "guidance_scale": 3.5,
        "output_quality": 80,
        "prompt_strength": 0.8,
        "extra_lora_scale": 0.8,
        "num_inference_steps": 42
    }
)
print(output)

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

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run ludocomito/flux-kuji using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "version": "5001e4db8ed2bce55e46f4323c8735bf571a66223a2be97d082c029852b2e036",
    "input": {
      "model": "dev",
      "prompt": "sunny beach in the style of KUJI",
      "go_fast": false,
      "lora_scale": 1,
      "megapixels": "1",
      "num_outputs": 1,
      "aspect_ratio": "1:1",
      "output_format": "webp",
      "guidance_scale": 3.5,
      "output_quality": 80,
      "prompt_strength": 0.8,
      "extra_lora_scale": 0.8,
      "num_inference_steps": 42
    }
  }' \
  https://api.replicate.com/v1/predictions

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

You can run this model locally using Cog. First, install Cog:

brew install cog

If you don’t have Homebrew, there are other installation options available.

Run this to download the model and run it in your local environment:

cog predict r8.im/ludocomito/flux-kuji@sha256:5001e4db8ed2bce55e46f4323c8735bf571a66223a2be97d082c029852b2e036 \
  -i 'model="dev"' \
  -i 'prompt="sunny beach in the style of KUJI"' \
  -i 'go_fast=false' \
  -i 'lora_scale=1' \
  -i 'megapixels="1"' \
  -i 'num_outputs=1' \
  -i 'aspect_ratio="1:1"' \
  -i 'output_format="webp"' \
  -i 'guidance_scale=3.5' \
  -i 'output_quality=80' \
  -i 'prompt_strength=0.8' \
  -i 'extra_lora_scale=0.8' \
  -i 'num_inference_steps=42'

To learn more, take a look at the Cog documentation.

Run this to download the model and run it in your local environment:

docker run -d -p 5000:5000 --gpus=all r8.im/ludocomito/flux-kuji@sha256:5001e4db8ed2bce55e46f4323c8735bf571a66223a2be97d082c029852b2e036
curl -s -X POST \
  -H "Content-Type: application/json" \
  -d $'{
    "input": {
      "model": "dev",
      "prompt": "sunny beach in the style of KUJI",
      "go_fast": false,
      "lora_scale": 1,
      "megapixels": "1",
      "num_outputs": 1,
      "aspect_ratio": "1:1",
      "output_format": "webp",
      "guidance_scale": 3.5,
      "output_quality": 80,
      "prompt_strength": 0.8,
      "extra_lora_scale": 0.8,
      "num_inference_steps": 42
    }
  }' \
  http://localhost:5000/predictions

To learn more, take a look at the Cog documentation.

Output

{
  "completed_at": "2024-08-26T20:21:15.085923Z",
  "created_at": "2024-08-26T20:20:47.944000Z",
  "data_removed": false,
  "error": null,
  "id": "qyvp8dh8s1rm00chj1cszat6hc",
  "input": {
    "model": "dev",
    "prompt": "sunny beach in the style of KUJI",
    "lora_scale": 1,
    "num_outputs": 1,
    "aspect_ratio": "1:1",
    "output_format": "webp",
    "guidance_scale": 3.5,
    "output_quality": 80,
    "extra_lora_scale": 0.8,
    "num_inference_steps": 42
  },
  "logs": "Using seed: 9545\nPrompt: sunny beach in the style of KUJI\ntxt2img mode\nUsing dev model\nfree=9530279374848\nDownloading weights\n2024-08-26T20:20:49Z | INFO  | [ Initiating ] chunk_size=150M dest=/tmp/tmpdjcmfqfx/weights url=https://replicate.delivery/yhqm/kT1XobqVJKblIl6YnYiTHMf6zti7TepRVf0KG1GbLk23pStmA/trained_model.tar\n2024-08-26T20:20:53Z | INFO  | [ Complete ] dest=/tmp/tmpdjcmfqfx/weights size=\"172 MB\" total_elapsed=3.468s url=https://replicate.delivery/yhqm/kT1XobqVJKblIl6YnYiTHMf6zti7TepRVf0KG1GbLk23pStmA/trained_model.tar\nDownloaded weights in 3.50s\nLoaded LoRAs in 13.42s\n  0%|          | 0/42 [00:00<?, ?it/s]\n  2%|▏         | 1/42 [00:00<00:11,  3.70it/s]\n  5%|▍         | 2/42 [00:00<00:09,  4.25it/s]\n  7%|▋         | 3/42 [00:00<00:09,  3.97it/s]\n 10%|▉         | 4/42 [00:01<00:09,  3.85it/s]\n 12%|█▏        | 5/42 [00:01<00:09,  3.79it/s]\n 14%|█▍        | 6/42 [00:01<00:09,  3.76it/s]\n 17%|█▋        | 7/42 [00:01<00:09,  3.73it/s]\n 19%|█▉        | 8/42 [00:02<00:09,  3.72it/s]\n 21%|██▏       | 9/42 [00:02<00:08,  3.71it/s]\n 24%|██▍       | 10/42 [00:02<00:08,  3.70it/s]\n 26%|██▌       | 11/42 [00:02<00:08,  3.69it/s]\n 29%|██▊       | 12/42 [00:03<00:08,  3.69it/s]\n 31%|███       | 13/42 [00:03<00:07,  3.69it/s]\n 33%|███▎      | 14/42 [00:03<00:07,  3.69it/s]\n 36%|███▌      | 15/42 [00:04<00:07,  3.69it/s]\n 38%|███▊      | 16/42 [00:04<00:07,  3.69it/s]\n 40%|████      | 17/42 [00:04<00:06,  3.69it/s]\n 43%|████▎     | 18/42 [00:04<00:06,  3.69it/s]\n 45%|████▌     | 19/42 [00:05<00:06,  3.68it/s]\n 48%|████▊     | 20/42 [00:05<00:05,  3.68it/s]\n 50%|█████     | 21/42 [00:05<00:05,  3.68it/s]\n 52%|█████▏    | 22/42 [00:05<00:05,  3.68it/s]\n 55%|█████▍    | 23/42 [00:06<00:05,  3.68it/s]\n 57%|█████▋    | 24/42 [00:06<00:04,  3.68it/s]\n 60%|█████▉    | 25/42 [00:06<00:04,  3.69it/s]\n 62%|██████▏   | 26/42 [00:06<00:04,  3.69it/s]\n 64%|██████▍   | 27/42 [00:07<00:04,  3.68it/s]\n 67%|██████▋   | 28/42 [00:07<00:03,  3.68it/s]\n 69%|██████▉   | 29/42 [00:07<00:03,  3.69it/s]\n 71%|███████▏  | 30/42 [00:08<00:03,  3.68it/s]\n 74%|███████▍  | 31/42 [00:08<00:02,  3.68it/s]\n 76%|███████▌  | 32/42 [00:08<00:02,  3.68it/s]\n 79%|███████▊  | 33/42 [00:08<00:02,  3.69it/s]\n 81%|████████  | 34/42 [00:09<00:02,  3.69it/s]\n 83%|████████▎ | 35/42 [00:09<00:01,  3.68it/s]\n 86%|████████▌ | 36/42 [00:09<00:01,  3.68it/s]\n 88%|████████▊ | 37/42 [00:09<00:01,  3.69it/s]\n 90%|█████████ | 38/42 [00:10<00:01,  3.69it/s]\n 93%|█████████▎| 39/42 [00:10<00:00,  3.68it/s]\n 95%|█████████▌| 40/42 [00:10<00:00,  3.68it/s]\n 98%|█████████▊| 41/42 [00:11<00:00,  3.68it/s]\n100%|██████████| 42/42 [00:11<00:00,  3.68it/s]\n100%|██████████| 42/42 [00:11<00:00,  3.70it/s]",
  "metrics": {
    "predict_time": 25.329081845,
    "total_time": 27.141923
  },
  "output": [
    "https://replicate.delivery/yhqm/iMbpFxwoKXptIhqWGGVNmKQwuSmHMyu7YKXzly5GNYsuVq1E/out-0.webp"
  ],
  "started_at": "2024-08-26T20:20:49.756841Z",
  "status": "succeeded",
  "urls": {
    "get": "https://api.replicate.com/v1/predictions/qyvp8dh8s1rm00chj1cszat6hc",
    "cancel": "https://api.replicate.com/v1/predictions/qyvp8dh8s1rm00chj1cszat6hc/cancel"
  },
  "version": "5001e4db8ed2bce55e46f4323c8735bf571a66223a2be97d082c029852b2e036"
}

Generated in

25.3 seconds

Tweak it ShareReport

Using seed: 9545
Prompt: sunny beach in the style of KUJI
txt2img mode
Using dev model
free=9530279374848
Downloading weights
2024-08-26T20:20:49Z | INFO  | [ Initiating ] chunk_size=150M dest=/tmp/tmpdjcmfqfx/weights url=https://replicate.delivery/yhqm/kT1XobqVJKblIl6YnYiTHMf6zti7TepRVf0KG1GbLk23pStmA/trained_model.tar
2024-08-26T20:20:53Z | INFO  | [ Complete ] dest=/tmp/tmpdjcmfqfx/weights size="172 MB" total_elapsed=3.468s url=https://replicate.delivery/yhqm/kT1XobqVJKblIl6YnYiTHMf6zti7TepRVf0KG1GbLk23pStmA/trained_model.tar
Downloaded weights in 3.50s
Loaded LoRAs in 13.42s
  0%|          | 0/42 [00:00<?, ?it/s]
  2%|▏         | 1/42 [00:00<00:11,  3.70it/s]
  5%|▍         | 2/42 [00:00<00:09,  4.25it/s]
  7%|▋         | 3/42 [00:00<00:09,  3.97it/s]
 10%|▉         | 4/42 [00:01<00:09,  3.85it/s]
 12%|█▏        | 5/42 [00:01<00:09,  3.79it/s]
 14%|█▍        | 6/42 [00:01<00:09,  3.76it/s]
 17%|█▋        | 7/42 [00:01<00:09,  3.73it/s]
 19%|█▉        | 8/42 [00:02<00:09,  3.72it/s]
 21%|██▏       | 9/42 [00:02<00:08,  3.71it/s]
 24%|██▍       | 10/42 [00:02<00:08,  3.70it/s]
 26%|██▌       | 11/42 [00:02<00:08,  3.69it/s]
 29%|██▊       | 12/42 [00:03<00:08,  3.69it/s]
 31%|███       | 13/42 [00:03<00:07,  3.69it/s]
 33%|███▎      | 14/42 [00:03<00:07,  3.69it/s]
 36%|███▌      | 15/42 [00:04<00:07,  3.69it/s]
 38%|███▊      | 16/42 [00:04<00:07,  3.69it/s]
 40%|████      | 17/42 [00:04<00:06,  3.69it/s]
 43%|████▎     | 18/42 [00:04<00:06,  3.69it/s]
 45%|████▌     | 19/42 [00:05<00:06,  3.68it/s]
 48%|████▊     | 20/42 [00:05<00:05,  3.68it/s]
 50%|█████     | 21/42 [00:05<00:05,  3.68it/s]
 52%|█████▏    | 22/42 [00:05<00:05,  3.68it/s]
 55%|█████▍    | 23/42 [00:06<00:05,  3.68it/s]
 57%|█████▋    | 24/42 [00:06<00:04,  3.68it/s]
 60%|█████▉    | 25/42 [00:06<00:04,  3.69it/s]
 62%|██████▏   | 26/42 [00:06<00:04,  3.69it/s]
 64%|██████▍   | 27/42 [00:07<00:04,  3.68it/s]
 67%|██████▋   | 28/42 [00:07<00:03,  3.68it/s]
 69%|██████▉   | 29/42 [00:07<00:03,  3.69it/s]
 71%|███████▏  | 30/42 [00:08<00:03,  3.68it/s]
 74%|███████▍  | 31/42 [00:08<00:02,  3.68it/s]
 76%|███████▌  | 32/42 [00:08<00:02,  3.68it/s]
 79%|███████▊  | 33/42 [00:08<00:02,  3.69it/s]
 81%|████████  | 34/42 [00:09<00:02,  3.69it/s]
 83%|████████▎ | 35/42 [00:09<00:01,  3.68it/s]
 86%|████████▌ | 36/42 [00:09<00:01,  3.68it/s]
 88%|████████▊ | 37/42 [00:09<00:01,  3.69it/s]
 90%|█████████ | 38/42 [00:10<00:01,  3.69it/s]
 93%|█████████▎| 39/42 [00:10<00:00,  3.68it/s]
 95%|█████████▌| 40/42 [00:10<00:00,  3.68it/s]
 98%|█████████▊| 41/42 [00:11<00:00,  3.68it/s]
100%|██████████| 42/42 [00:11<00:00,  3.68it/s]
100%|██████████| 42/42 [00:11<00:00,  3.70it/s]

Examples

View more examples

Run time and cost

This model runs on Nvidia H100 GPU hardware. We don't yet have enough runs of this model to provide performance information.

Readme

This model doesn't have a readme.