Build with Parallax Background
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 -X POST 'https://sorceress.games/api/v1/tools/parallax_v2_convert' \
-H 'Authorization: Bearer $SORCERESS_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"assetId": "<assetId>"
}'Inputs & settings
assetIdstringRequiredresolutionstring1K, 2K or 4K
aspectRatiostringscreenstringgreen or blue
Full input schema
{
"required": [
"assetId"
],
"properties": {
"assetId": {
"type": "string",
"title": "asset Id"
},
"resolution": {
"type": "string",
"title": "resolution",
"description": "1K, 2K or 4K"
},
"aspectRatio": {
"type": "string",
"title": "aspect Ratio"
},
"screen": {
"type": "string",
"title": "screen",
"description": "green or blue"
}
}
}Workflow actions
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.
Parallax · Presets & GuideParallax Background agent guide: 4-layer roles, scene presets with ready prompts, green-screen/edge/seamless clauses, engine depth/composite hints, and Corridor Key vs classic chroma instructions. Synchronous / free. Call this first.
Parallax · Prompt HelperMagic Prompt Helper: turn a scene idea into four Parallax layer prompts (Ground, Midground, Background, Foreground) with green-screen clauses baked in. Synchronous / free. Next: image_generate each finalized prompt, then parallax_key on slots 0/1/3.
Parallax · Corridor KeyCorridor Key green/blue-screen removal for still Parallax layer images. DEFAULT after image_generate for Ground/Midground/Foreground — pass imageUrl, poll until succeeded, use transparentUrl. Do not key Background (slot 2). Prefer over DIY chroma unless the user asks. For general stills use corridor_key. Async — poll GET /api/v1/jobs/:id.
Parallax · List ProjectsList Parallax projects saved in the website UI for this account (Project dropdown). Synchronous / free. Then call parallax_get with projectId or name to load full config + layer URLs.
Parallax · Get ProjectLoad one saved Parallax project by projectId or name (e.g. "forest 2") — prompts, aspect, per-layer image/transparent URLs, scale/offset, BG-removal settings, engineHints. Same snapshot as the website Project dropdown. Synchronous / free.
Parallax V2 · Convert SceneConvert a saved V2 reference scene into four matching layers, key the three foreground layers, save back to the same scene and export a ZIP. Persisted async workflow. Each successful image/key operation uses existing pricing; completed child jobs remain billed if a later step fails.
Parallax V2 · Create WorkspaceCreate an owned workspace in the V2 gallery.
Parallax V2 · Save SceneSave an image from your completed image job into a V2 workspace, with a gallery thumbnail.
Parallax V2 · Workspaces & ScenesList saved workspaces and scenes from /parallax-v2 for this account.
Parallax V2 · Get SceneLoad a saved V2 scene with its four generated layers, transparent URLs and placement settings.
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.
