Using AutoSprite 3.0 in your workflow

Sorceress brings this custom workflow into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.

Create and animate character sprites with the AutoSprite 3.0 workflow.
Use the supporting keying and attachment actions within one sprite production pipeline.

Pricing and availability

Pricing varies by action and model; see the actions below. Successful work is billed in Sorceress credits. Defaults and optional inputs can affect the total.

Inputs and supported options

startPoseIdstring · optional

Saved pose ID from get_character or create_start_pose. Default original. Can be overridden per animations[] item; all pose IDs are validated before any generation starts.

characterAssetIdstring · required

Character asset id from autosprite_create_character (or the V3 UI).

animationsarray · required

Array of { label, prompt, duration?, startPoseId? }. Duration seconds 2–10 (default 5). The agent writes the prompts — no separate "generate prompts" step.

modelstring · optional

Video model: "imagine-1.5" (default) or "wan-2.7". VIP accounts get the discounted Imagine route automatically.

resolutionstring · optional

720p (default) or 1080p where the model supports it.

Workflow actions

AutoSprite · Create Start Pose

Capture a source-video frame or calibrate a canvas without resizing the character. Saves a reusable pose under the same character Job ID. Free. 4:5 taller canvas defaults to upward padding.

0 credits per successful call

AutoSprite · Inspect Frames

Review numbered source-video or sheet frames. Returns contact-sheet image URL, coordinate space, blank/edge heuristics. Free; visual judgment is required for airborne poses and clipped limbs.

0 credits per successful call

AutoSprite · Save Frame Tags

Save sparse ordered frame sections and per-tag timing in the same analyzer as the website. Requires current sheet URL and analyzer revision; preserves other metadata. Free; dryRun validates only.

0 credits per successful call

AutoSprite · List

List AutoSprite V3 workspaces and assets (characters + animations). Assets come from ONE workspace per call (default workspace unless workspaceId is passed) — for an asset by ID from any workspace use autosprite_get_character instead of re-listing. Returns HD mediaUrl / spriteSheetUrl only — not gallery hover thumbnails. Synchronous.

0 credits per successful call

AutoSprite · Create Character

Save a character image into AutoSprite V3 (usually the result of image_generate on a chroma screen — green is the usual generate default; blue also keys). Synchronous — returns assetId for autosprite_animate.

0 credits per successful call

AutoSprite · Get Character Pack

Load AutoSprite V3 by ID. Character Job ID (gallery card) → full character + all animations. Animation Anim ID (Animate Studio clip card) → that one clip with HD spriteSheetUrl, keyed sheets, and sprite-analyzer/tag config. Synchronous. Prefer when a human hands an ID from /autosprite-v3 to a coding agent. For clip-aligned SFX, follow with autosprite_get_sounds or video_extract_audio.

0 credits per successful call

AutoSprite · Get Animation Sounds

Extract MP3 soundtracks from AutoSprite V3 animations (same baked-in SFX as Animate Studio "Sounds" / Full pack). Pass character jobId for the whole pack, or assetIds[] for a subset. Free / sync / cached. Large packs may return partial:true — call again with the same input until partial is false (done clips are instant). Prefer these clip-aligned sounds over generating new SFX unless the user asks.

0 credits per successful call

AutoSprite · Animate

Generate image-to-video animations for a V3 character (raw chroma-screen MP4s). Async — poll GET /api/v1/jobs/:id to finalize (provider runs in the background; poll does not push frames). On failed/Internal Error, retry animate — do not keep polling a dead jobId. DEFAULT NEXT STEP after each video succeeds: autosprite_key → keep polling until keyed sheet is ready.

Same per-second video rates as Animate Studio (Imagine 1.5 / Wan 2.7). Charged only when each job succeeds.

AutoSprite · Corridor Key

Corridor Key green/blue-screen removal for AutoSprite V3 animation videos via Sorceress cloud GPU. DEFAULT after autosprite_animate. Pass assetId (or assetIds[]). keyColor "auto" detects green or blue. Already-keyed clips are returned instantly in alreadyKeyed[] with their existing spriteSheetUrl (no job, no charge) — pass force:true to re-key. Async CHUNKED WORKER — each poll advances only a few frames; you MUST keep polling until succeeded or the sheet never lands. For FREE local GPU keying, start sorcgcs-server and use WizardGenie backend:"local", or key yourself then call autosprite_attach_keyed (see tool notes).

Same as V3 UI Corridor Key: ~1 credit per 10 frames at ≤512px (2× when frames are larger — UI/API default working size is 512; pass maxSide 1024 for higher quality). VIP free. Charged only when the HD sheet is saved. Local keying via autosprite_attach_keyed is always free.

AutoSprite · Attach Keyed Sheet

Save a pre-keyed transparent sprite sheet onto an AutoSprite V3 animation (same gallery KEYED state as cloud Corridor Key). Free / sync. Use after local Corridor Key (sorcgcs-server on :8100): file_upload the PNG, then attach with grid meta. WizardGenie sorceress_autosprite_key backend:"local" does this end-to-end.

0 credits per successful call

Corridor Key · Still Image

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.

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.

API request template

Replace placeholders and choose valid values from the input contract.

POST /api/v1/tools/autosprite_animate
Authorization: Bearer $SORCERESS_API_KEY
Content-Type: application/json

{
  "characterAssetId": "<characterAssetId>",
  "animations": []
}

Read the endpoint reference →

Completion, results and billing

Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.

Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.