View as Markdown
Runware icon

Runware ACTION

Image Control Net Preprocess

Request an image control net preprocess task to be processed by the Runware API. See the documentation.
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Runware account once, then configure and run Image Control Net Preprocess from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "runware-image-control-net-preprocess",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    runware: { authProvisionId: "apn_xxxxxxx" },
    inputImage: "Input Image",
    outputType: "Output Type",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Image Control Net Preprocess inputs
Property Type Description
inputImage Input Image string

Specifies the input image to be processed. The image can be specified in one of the following formats:

  • An UUID v4 string of a previously uploaded image or a generated image.
  • A data URI string representing the image. The data URI must be in the format data:<mediaType>;base64, followed by the base64-encoded image. For example: data:image/png;base64,iVBORw0KGgo....
  • A base64 encoded image without the data URI prefix. For example: iVBORw0KGgo....
  • A URL pointing to the image. The image must be accessible publicly. Supported formats are: PNG, JPG and WEBP.
Required
outputType Output Type string
Specifies the output type in which the image is returned.
Optional
outputFormat Output Format string
Specifies the format of the output image.
Optional
includeCost Include Cost boolean
If set to true, the cost to perform the task will be included in the response object. Defaults to false.
Optional
preProcessorType Preprocessor Type string
The preprocessor to be used.
Optional
height Height integer
Used to define the height dimension of the generated image. Certain models perform better with specific dimensions. The value must be divisible by 64, eg: 512, 576, 640 ... 2048.
Required
width Width integer
Used to define the width dimension of the generated image. Certain models perform better with specific dimensions. The value must be divisible by 64, eg: 512, 576, 640 ... 2048.
Required
lowThresholdCanny Low Threshold Canny integer
Defines the lower threshold when using the Canny edge detection preprocessor. The recommended value is 100.
Optional
highThresholdCanny High Threshold Canny integer
Defines the high threshold when using the Canny edge detection preprocessor. The recommended value is 200.
Optional
includeHandsAndFaceOpenPose Include Hands and Face OpenPose boolean
Include the hands and face in the pose outline when using the OpenPose preprocessor.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
runware-image-control-net-preprocess
Version
0.0.2
App
Runware
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes