PiAPI
HomeWorkspace
HomeWorkspace
Join Discord
  1. Flux
  • Get Started
    • Overview
    • Quickstart
    • Make Instruction: How to Use PiAPI to Build a Workflow on Make?
  • Endpoints
    • Flux
      • Flux with LoRA and Controlnet
      • Available LoRA and Controlnet
      • Flux API with Redux Variation, Fill, Inpaint and Outpaint
      • Create Task
        • Text to Image
        • Image to Image
        • Kontext
      • Get task
        GET
    • Gemini
      • Gemini-2.5-flash-image
      • Nano Banana Pro
      • Get task
    • Qwen Image
      • Text to Image
      • Image Edit
      • Get task
    • Faceswap
      • Multi Faceswap
      • Image Faceswap
      • Video Faceswap
      • Get Task
    • Kling
      • Lipsync With PiAPI Kling API Examples
      • Motion Brush With PiAPI Kling API Example
      • Kling Elements Video Generation API
      • Kling Effects Video Generation
      • Cancel Task
        • Cancel Tasks
        • Cancel Task
      • Get Task
      • Create Task
      • Kling Virtual Try-On
      • Kling Effects
      • Kling Sound
      • Kling Avatar
    • Veo3
      • Veo3 Text to Video
      • Veo3 Image to Video
      • Veo3.1 Text to Video
      • Veo3.1 Image to Video
      • Get task
    • Sora2
      • Sora2-preview Text to Video
      • Sora2 Text to Video
      • Sora2-Pro Text to Video
      • Sora2 Remove Watermark
      • Get task
    • WanX
      • Generate WanX Task with LoRA Using PiAPI
      • Available LoRA Types for Wanx
      • Use Cases for Wanx LoRA
      • Use Cases for Wanx Control Camera
      • Create Task
      • Get Task
    • Hailuo
      • Hailuo Director Mode Example
      • Generate Video
      • Get Task
    • Skyreels
      • Create Task
      • Get Task
    • Framepack
      • Create Task
      • Get Task
    • Hunyuan Video
      • How to Make a Hunyuan API Call
      • Available Hunyuan Lora models
      • Get Task
      • Generate Video
    • Luma Dream Machine
      • Cancel Task
        • Cancel Tasks
        • Cancel Task
      • Create Task
      • Get Task
    • LLM
      • Use Cases for GPT-4o Image API
      • How To Avoid Timeouts in Completion API
      • GPT-4o Image Generation API
      • LLM API | Basic Completions
    • Suno
      • Music
      • Lyrics
      • Get task
    • Song(Udio)
      • Song API Task Creation Examples
      • [Udio] Song Extend
      • Get Task
      • Create Task
      • [Udio] Generate Lyrics
    • Mmaudio
      • Get Task
      • Generate Audio
    • DiffRhythm
      • Generate Audio
      • Get Task
    • Ace Step
      • Create Task
        • Text to Audio
        • Audio to Audio
        • Audio Edit
        • Audio Extend
      • Get Task
    • TTS
      • Zeroshot Text-to-Speech F5-TTS
      • Get Task
    • Trellis
      • Create Task
      • Get Task
    • Joycaption
      • Image Caption
      • Get Task
    • Midjourney
      • PiAPI Penalties on Midjourney Usage
      • Detailed Explaination on Midjourney Task Result
      • Midjourney V7 API Instructions
      • Create Task
        • Imagine
        • Upscale
        • Variation
        • Reroll
        • Describe
        • Seed
        • Blend
        • Inpaint
        • Outpaint
        • Pan
      • Cancel Task
        • Cancel Task
        • Cancel Tasks
      • Get Task
    • AI Hug
      • Get Task
      • Create Task
    • Tools
      • File Upload API
      • Remove Background API
      • Remove Background-Get Task
      • Segment With Prompt API
      • Segment With Prompt API-Get Task
      • Image Upscale(Super Resolution) API
      • Image Upscale-Get Task
      • Video Upscale
      • Video Upscale-Get Task
      • Video Remove Background
      • Video Remove Background-Get task
    • PiAPI Account Management
      • PiAPI Account Info
      • Task List Info
      • User Task History
  • Resources
    • Change Log
    • Output Storage
    • Unified API Schema
    • Webhook
    • Bulk Generation Service
    • Billings
    • PiAPI MCP Server
    • Workspace Manual
      • Host-your-account (HYA) | Back-up Account
      • Host-your-account (HYA) | Debug Checklist
      • Host-your-account (HYA) | Connected Account Status
    • Announcements
      • PiAPI 2025 January 1st Pricing Update
      • The discontinued support for midjourney
  • Schemas
    • Schemas
      • motion brush
      • Create Task
      • camera control
      • Cancel Params
      • Float2 Point
      • Control Points
      • txt2video-1.3b
      • txt2video-14b
      • txt2video-14b-lora
      • img2video-14b
      • img2video-14b-lora
      • img2video-14b-keyframe
      • img2video-14b-control-camera
      • wan22-txt2video-14b
      • wan22-img2video-14b
      • hunyuan-txt2video-lora
      • Trellis API/text-to-3D
      • Trellis API/image-to-3D
      • VideoGenerationRequest
      • TaskRequest
      • VideoGenerationResponse
      • TaskConfig
      • TaskInput
      • TaskResponse
      • ErrorResponse
    • Response
      • Unified-Task-Response
    • RequestBodies
      • Unified-Task-Request-Body
    • config
    • control_net_setting
    • lora_setting
HomeWorkspace
HomeWorkspace
Join Discord
  1. Flux

Flux with LoRA and Controlnet

This service is provided by PiAPI in collaboration with Qubico's specialized inference hardware, designed to optimize LoRA (Low-Rank Adaptation) and ControlNet functionalities for advanced model control in various Flux tasks.

Flux API (Task Creation with LoRA and ControlNet)#

Model, Task Type and LoRA Numbers#

Model NameTask TypeLoRA CapacityControlnet Capacity
Qubico/flux1-dev-advancedtxt2img-lora10
Qubico/flux1-dev-advancedimg2img-lora10
Qubico/flux1-dev-advancedcontrolnet-lora0 or 11
Qubico/flux1-dev-advancedcontact us if you need a complex workflow customization>1>1
Note: Qubico/flux1-dev-advanced is the only model that supports LoRA and controlnet in PiAPI's Flux API. You can explore Available LoRA and Controlnet to find out what LoRA or Controlnet model that best fit your need.

Example: Request Body of Text-to-Image Task with ControlNet and LoRA#

{
  "model": "Qubico/flux1-dev-advanced",
  "task_type": "controlnet-lora",
  "input": {
    "prompt": "spiderman",
    "control_net_settings": [
      {
        "control_type": "depth",
        "control_image": "https://example.com/control_image2.png"
      }
    ],
    "lora_settings": [
      {
        "lora_type": "mjv6"
      }
    ]
  },
  "config": {
    "webhook_config": {
      "endpoint": "https://webhook.site/d35ab4aa-95f9-4855-af82-32fbfbb67063",
      "secret": ""
    }
  }
}

Request Example Using cURL#

Example: Request Body of Task Creation with LoRA only#

Input Example:
{
  "model": "Qubico/flux1-dev-advanced",
  "task_type": "txt2img-lora",
  "input": {
    "prompt": "spiderman",
    "lora_settings": [
      {
        "lora_type": "mjv6"
      }
    ]
  },
  "config": {
    "webhook_config": {
      "endpoint": "https://webhook.site/d35ab4aa-95f9-4855-af82-32fbfbb67063",
      "secret": ""
    }
  }
}

Example: Task Creation with controlnet Canny#

{
    "model": "Qubico/flux1-dev-advanced",
    "task_type": "controlnet-lora",
    "input": {
        "steps": 28,
        "prompt": "A girl in city, 25 years old, cool, futuristic",
        "negative_prompt": "low quality, ugly, distorted, artefacts",
        "guidance_scale": 2.5,
        "control_net_settings": [
            {
                "control_type": "canny",
                "control_image": "https://i.ibb.co/yX07dwV/Comfy-UI-controlnet.webp",
                "control_strength": 0.45,
                "return_preprocessed_image": true
            }
        ],
        "lora_settings": [
            {
                "lora_type": "graphic-portrait",
                "lora_strength": 1
            }
        ]
    },
    "config": {
        "webhook_config": {
            "endpoint": "",
            "secret": ""
        }
    }
}
Canny Result 1Canny Result 2
Alt text 1Alt text 2

Example: Task Creation with controlnet Depth#

{
    "model": "Qubico/flux1-dev-advanced",
    "task_type": "controlnet-lora",
    "input": {
        "steps": 28,
        "prompt": "A girl in city, 25 years old, cool, futuristic",
        "negative_prompt": "low quality, ugly, distorted, artefacts",
        "guidance_scale": 2.5,
        "control_net_settings": [
            {
                "control_type": "depth",
                "control_image": "https://i.ibb.co/yX07dwV/Comfy-UI-controlnet.webp",
                "control_strength": 0.45,
                "return_preprocessed_image": true
            }
        ],
        "lora_settings": [
            {
                "lora_type": "geometric-woman",
                "lora_strength": 1
            }
        ]
    },
    "config": {
        "webhook_config": {
            "endpoint": "",
            "secret": ""
        }
    }
}
Depth Result 1Depth Result 2
Alt text 1Alt text 2

Example: Task Creation with controlnet SoftEdge#

{
    "model": "Qubico/flux1-dev-advanced",
    "task_type": "controlnet-lora",
    "input": {
        "steps": 28,
        "prompt": "A girl in city, 25 years old, cool, futuristic",
        "negative_prompt": "low quality, ugly, distorted, artefacts",
        "guidance_scale": 2.5,
        "control_net_settings": [
            {
                "control_type": "soft_edge",
                "control_image": "https://i.ibb.co/yX07dwV/Comfy-UI-controlnet.webp",
                "control_strength": 0.55,
                "return_preprocessed_image": true
            }
        ],
        "lora_settings": [
            {
                "lora_type": "remes-abstract-poster-style",
                "lora_strength": 1
            }
        ]
    },
    "config": {
        "webhook_config": {
            "endpoint": "https://webhook.site/0edf5555-22ba-4aae-898a-f707440effa4",
            "secret": ""
        }
    }
}
Softedge Result 1Softedge Result 2
Alt text 1Alt text 2

Example: Task Creation with controlnet OpenPose#

{
    "model": "Qubico/flux1-dev-advanced",
    "task_type": "controlnet-lora",
    "input": {
        "steps": 28,
        "prompt": "person enjoying a day at the park, full hd, cinematic",
        "negative_prompt": "low quality, ugly, distorted, artefacts",
        "guidance_scale": 4.0,
        "control_net_settings": [
            {
                "control_type": "openpose",
                "control_image": "https://i.ibb.co/vkCbMZY/3-pose-1024.jpg",
                "control_strength": 0.7,
                "return_preprocessed_image": true
            }
        ],
        "lora_settings": [
            {
                "lora_type": "mjv6",
                "lora_strength": 1
            }
        ]
    },
    "config": {
        "webhook_config": {
            "endpoint": "https://webhook.site/0edf5555-22ba-4aae-898a-f707440effa4",
            "secret": ""
        }
    }
}
OpenPose Control Image INPUTOpenPose Result
Alt text 1Alt text 2
Modified at 2025-04-22 06:31:15
Previous
Endpoints
Next
Available LoRA and Controlnet