io.github.svatrous/longtake

Delete a take. A queued BytePlus take is also cancelled at the provider, so its tokens are not burned. Everywhere else this is only a delete: Veo, Omni and Kling accept the render when it is created and have no cancel at all, and a take that is already running cannot be called back on any engine — it is paid for and the file is thrown away.

Create a character: name (for @mentions) + appearance (a local sheet via imageFilePath, or a library assetId) + voice (audio file or assetId). The voice is locked in — it does not change from scene to scene. A character with a portrait is screen-tested automatically: a 4s clip is rendered to find out whether the reference clears content moderation, and the verdict comes back in `check` ("rejected" = the portrait reads as a real person and every take with it would fail — replace it with a clearly animated one or a verified actor asset://).

Create a folder (episode) in a project — a "Scene 1" appears inside.

Create a project (scaffolded with "Episode 1" and "Scene 1").

Create a scene in a folder.

Estimate generation cost before running. Seedance is billed in tokens (duration × width × height × 24 / 1024, at a $/M rate that differs per model and resolution); Veo and Kling are billed by the second; Gemini Omni is billed by tokens it decides after the fact, so its figure is a pessimistic guess. A Seedance 2.5 draft (generate_video draft: true) costs exactly a 480p take on 2.5 — price it with that model, not the default; its final (finish_draft) costs a 1080p take on 2.5 of the draft's duration and ratio, plus the draft's referenceVideoSec from take_status.

Finish a Seedance 2.5 draft (a take shot with generate_video draft: true) in 1080p. The model renders the SAME shot again at full size: composition, camera path, blocking, timing, faces and sound carry over, fine detail is drawn again — and so are the draft's mistakes. A new 1080p take gives a different video; an upscale works from the draft's pixels alone. Billed as an ordinary 1080p take of the draft's length on 2.5 — about $2.84 per 5 s at 16:9 at list price. Quote it with estimate_cost once the draft has succeeded (its values are the real ones then): model 2.5, resolution 1080p, and duration, ratio and referenceVideoSec from the draft's take_status. The final is a new take in the draft's scene; the draft stays. Possible for 7 days after the draft, on the key it was shot on. A draft has one live final at a time: calling this again returns that final instead of paying twice, while a failed or deleted final can be finished again — and is paid again.

Generate a character mockup sheet (21:9, 4 panels: full-body front·profile·back·portrait). From a real-person photo (photoPaths) and/or a text description. Engine: Seedream (BytePlus) with a Gemini fallback. The result is saved as an asset in the library. Pass its id to create_character as imageAssetId to cast it — the sheet gets the anti-moderation grain at that moment.

Generate a take (video) in a scene. In the prompt you can reference characters and assets by @name (see studio_overview) — the studio attaches portraits, voices and references itself. A @clip from the library goes to Seedance as a reference video (say what to take from it: "the camera movement of @clip", "the pacing of @clip"); up to 3 clips per take on the 2.0 family, 10 on 2.5, 30 s of reference video in total, and every second of it is billed on top of the take. Write the prompt in English: Russian is not among the prompt languages of these models, and the studio translates it only if its owner switched translation on. With draft: true it shoots a Seedance 2.5 draft — 480p, billed as an ordinary 480p take — that finish_draft can later render again as the same shot in 1080p; shoot several (variants) and finish the one that works. The task is async: track it via take_status.

Scene takes (brief, newest first). A Seedance 2.5 draft is marked draft: true; a draft's 1080p final carries finishOf.

Studio overview: projects with folders and scenes (ids and names), characters, assets, active renders. Call this first — all other tools use ids from here.

Take status: queued/running/succeeded/failed + video file, last frame, token spend, and what the take was shot as: model, resolution, ratio, duration and referenceVideoSec (seconds of @clips it was billed for). A Seedance 2.5 draft carries draft: true and final — its live 1080p final, or null; a final carries finishOf, the draft it was made from.

Upload a local file (image, audio, or a reference clip) to the project library. Returns the name for @mentions. A library picture referenced as @name reaches the video model exactly as it is — to put a face in front of a video model, make it a character's portrait (create_character): that lays the anti-moderation grain on it. A clip (mp4/mov, 2–30 s, 480p or 720p) mentioned as @name goes to Seedance as a reference video — motion, camera movement, pacing, an effect — and its seconds are billed as input on top of the take; pass durationSec (and width/height) so the studio can check the limits before any money moves.