Input

image Url*Upload file

https URL of a chroma-screen still (green or blue). e.g. images[0].url from image_generate, or a publicUrl from file_upload.

key Color

"auto" (default — detect green or blue plate from image borders) or a hex like "#00b140" / "#0040FF".

screen Color

Corridor Key checkpoint: "auto" (default, from the detected/hex plate), "green", or "blue". Use when auto-detect is unsure.

tolerance

Chroma distance tolerance for the alpha hint (default 80).

max Side

Max working side before Corridor Key (512 = fast default, 1024 or 1536 = higher quality). Source is fit inside this box without upscaling.

label

Optional short label stored on the job / gallery row (e.g. filename).

Runs use your account credits. View this model’s prices100 credits = $1.00 USD · Charged for successful work.

Checking your session…

Output

A little curiosity. A new creation.

Give Corridor Key an input and see what it can do. Your result will appear here.

Meet the model

Remove green or blue backgrounds from images

Corridor Key green/blue-screen removal for any still image. Pass imageUrl, poll until succeeded, use transparentUrl. Same cloud GPU as /corridor-chroma. keyColor "auto" detects the plate. For AutoSprite videos use autosprite_key; for Parallax layers you may use this or parallax_key. Async — poll GET /api/v1/jobs/:id.

What you can do

Remove a green or blue background from a still image while preserving transparency.
Prepare keyed sprites and layers for compositing; choose a working size up to 1536 pixels.

From experiment to application

Try a prompt in the playground, adjust the supported settings, then use the same model in your app. Your account balance works across the playground and API.

Connect an AI agent →

Creator

Sorceress

Make your first request

Use your Sorceress API key on your server. The playground uses your signed-in account; your application uses the same model with an API key.

cURL request

curl -X POST 'https://sorceress.games/api/v1/tools/corridor_key' \
  -H 'Authorization: Bearer $SORCERESS_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "imageUrl": "<imageUrl>"
}'

Full endpoint reference →

Inputs & settings

imageUrlstringRequired

https URL of a chroma-screen still (green or blue). e.g. images[0].url from image_generate, or a publicUrl from file_upload.

keyColorstring

"auto" (default — detect green or blue plate from image borders) or a hex like "#00b140" / "#0040FF".

screenColorstring

Corridor Key checkpoint: "auto" (default, from the detected/hex plate), "green", or "blue". Use when auto-detect is unsure.

tolerancenumber

Chroma distance tolerance for the alpha hint (default 80).

maxSidenumber

Max working side before Corridor Key (512 = fast default, 1024 or 1536 = higher quality). Source is fit inside this box without upscaling.

labelstring

Optional short label stored on the job / gallery row (e.g. filename).

Full input schema

Input schema

{
  "required": [
    "imageUrl"
  ],
  "properties": {
    "imageUrl": {
      "type": "string",
      "title": "image Url",
      "description": "https URL of a chroma-screen still (green or blue). e.g. images[0].url from image_generate, or a publicUrl from file_upload.",
      "format": "uri"
    },
    "keyColor": {
      "type": "string",
      "title": "key Color",
      "description": "\"auto\" (default — detect green or blue plate from image borders) or a hex like \"#00b140\" / \"#0040FF\"."
    },
    "screenColor": {
      "type": "string",
      "title": "screen Color",
      "description": "Corridor Key checkpoint: \"auto\" (default, from the detected/hex plate), \"green\", or \"blue\". Use when auto-detect is unsure."
    },
    "tolerance": {
      "type": "number",
      "title": "tolerance",
      "description": "Chroma distance tolerance for the alpha hint (default 80)."
    },
    "maxSide": {
      "type": "number",
      "title": "max Side",
      "description": "Max working side before Corridor Key (512 = fast default, 1024 or 1536 = higher quality). Source is fit inside this box without upscaling."
    },
    "label": {
      "type": "string",
      "title": "label",
      "description": "Optional short label stored on the job / gallery row (e.g. filename)."
    }
  }
}

Results, saved runs & billing

Media requests return a job ID. Poll GET /api/v1/jobs/:id until it succeeds or fails; keep the same ID while it is processing. Long chat requests can also return a saved job to poll. Completed outputs are stored in your account, and successful work is billed using your model's current rates.

A multi-step workflow may include separately billed successful actions. If a connection drops, check your saved run before submitting it again.

Know the cost

Pricing that makes sense

Dollar values are the USD equivalent of your Sorceress credits.

100 credits = $1.001 credit = $0.01 USD

Sorceress credits

Priced by usage

Same as UI Corridor Chroma stills: ~1 credit per image at ≤512px (2× above 512). VIP free. Charged only on success. Local GPU via sorcgcs-server is free.

1 credit = $0.01 · Successful work is billed on completion.

Review the supported inputs for duration, quantity and other usage-based charges before submitting. Read the billing guide →

Corridor Key API