# ControlNet Scribble

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

- **Provider**: replicate
- **Model ID**: jagilley/controlnet-scribble
- **Category**: sketch_to_image
- **Credits**: 120 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `image` (string, **required**): Input image
- `eta` (number, optional): eta (DDIM) (Default: `0`)
- `seed` (integer, optional): Seed
- `image_resolution` (string, optional): Image resolution to be generated (Default: `512`; Options: `256`, `512`, `768`)
- `ddim_steps` (integer, optional): Steps (Default: `20`)
- `scale` (number, optional): Guidance Scale (Default: `9`; Range: min: 0.1, max: 30)
- `a_prompt` (string, optional): Added Prompt (Default: `best quality, extremely detailed`)
- `prompt` (string, **required**): Prompt for the model
- `num_samples` (string, optional): Number of samples (higher values may OOM) (Default: `1`; Options: `1`, `4`)
- `n_prompt` (string, optional): Negative Prompt (Default: `longbody, lowres, bad anatomy, bad hands, missing fingers, extra digit, fewer digits, cropped, worst quality, low quality`)

## Example Request

```json
{
  "model": "jagilley/controlnet-scribble",
  "input": {
    "image": "https://replicate.delivery/pbxt/IJE6zP4jtdwxe7SffC7te9DPHWHW99dMXED5AWamlBNcvxn0/user_1.png",
    "image_resolution": "512",
    "scale": 9,
    "a_prompt": "best quality, extremely detailed",
    "ddim_steps": 20,
    "prompt": "a photo of a brightly colored turtle",
    "n_prompt": "longbody, lowres, bad anatomy, bad hands, missing fingers, extra digit, fewer digits, cropped, worst quality, low quality",
    "num_samples": "1"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

sketch-to-image, controlnet, scribble, drawing, stable-diffusion

## Documentation

https://replicate.com/jagilley/controlnet-scribble