ControlNetMediumHigh

ControlNet Scribble

The classic sketch-to-image model (38M+ runs) — turn any scribble or line drawing into a detailed image guided by your prompt. Draw the composition, describe the content.

120 credits

per run (num_samples '4' costs 480)

Sketch controls composition, prompt controls content

38M+ runs — the scribble standard

1 or 4 samples per run

Additional prompt / negative prompt refinement

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "jagilley/controlnet-scribble",
  "input": {
    "image": "https://example.com/house-sketch.png",
    "prompt": "a cozy cottage in a forest, warm sunset light, storybook illustration",
    "image_resolution": "512"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	What the final image should be
`image`	string	Yes	-	Scribble/line drawing input
`num_samples`	string	No	1	Number of images ('1' or '4'). '4' is billed 4x 14
`image_resolution`	string	No	512	Output resolution 256512768
`ddim_steps`	integer	No	20	Denoising steps
`scale`	number	No	9	Prompt guidance scale (0.1-30)
`seed`	integer	No	-	Random seed
`eta`	number	No	0	eta (DDIM)
`a_prompt`	string	No	best quality, extremely detailed	Added quality prompt
`n_prompt`	string	No	longbody, lowres, bad anatomy, bad hands, missing fingers, extra digit, fewer digits, cropped, worst quality, low quality	Negative prompt

How to Provide File Input

There are 3 ways to provide files for the image parameter:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=jagilley/controlnet-scribble" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "jagilley/controlnet-scribble",
  "input": {
    "prompt": "your prompt here",
    "image": "https://example.com/image.jpg"
  }
}

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Sketch to Illustration

Turn a rough house sketch into a detailed illustration

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "jagilley/controlnet-scribble",
  "input": {
    "image": "https://example.com/house-sketch.png",
    "prompt": "a cozy cottage in a forest, warm sunset light, storybook illustration",
    "image_resolution": "512"
  }
}'