---
title: "Media · Image · Scribble to image (ControlNet)"
method: POST
path: "/api/v1/tools/sd-scrible"
tags: ["edit"]
---

# Media · Image · Scribble to image (ControlNet)

`POST /api/v1/tools/sd-scrible`

## Request

- Base URL: `https://api.simplified.com`
- URL: `https://api.simplified.com/api/v1/tools/sd-scrible`
- Auth: API key in header `Authorization`

Turn a rough sketch/scribble into a finished image via Stable Diffusion
ControlNet, steered by `prompt` (and `negative_prompt`). Pass the scribble
as `image_url` or base64 `image`. Generates a NEW image from line art; to
edit an existing photo use `magicInpaint` / `generativeFill`. Async —
returns a task_id (auto-polled).

## Request body

- object
  - `prompt` string, required: Text description of the desired output image.
  - `negative_prompt` string, required: What to avoid in the generated image.
  - `image_url` string: URL of the scribble/sketch input image.
  - `image` string: Base64-encoded scribble image (alternative to image_url).
  - `image_resolution` integer: Output resolution in pixels.
  - `steps` integer: Diffusion steps (higher = better quality, slower).
  - `guidance_scale` number, double: How closely to follow the prompt.
  - `counts` integer: Number of variations to generate.

## Response `202`

Async task queued.

- AsyncTaskResponse
  - `task_id` string: Poll GET /api/v1/tasks/{task_id} until SUCCESS or FAILURE.

---

[API](https://skmtc.dev/simplified/apis/image-tools.md) - [All operations](https://skmtc.dev/simplified/apis/image-tools/llms.txt) - [OpenAPI document](https://skmtc.dev/simplified/apis/image-tools/revisions/7de7bf8f6707?raw)