Phantra AI: Edit And Deliver
Trims, joins, and reformats rendered clips from the library, then shares a temporary download link; all edits create new items and are free.
Edit and deliver
A rendered clip is in the person's library as gen:<id>; a clip or picture
they brought in is asset:<id>. Four tools finish a video from there, all on
the studio's own server, all free. Each makes a NEW item; no source is ever
changed or deleted. Nothing in this skill makes a clip that was never rendered.
| step | tool | what it costs |
|---|---|---|
| find clips and uploads | library, search (scene only says which shots have a clip) | nothing |
| keep a range of one clip | trim_clip | nothing |
| join clips, optional music | assemble_clips | nothing |
| a copy in another shape | reformat | nothing |
| a download link | share_link | nothing |
Find the clips
librarywithkind=video(andproject_idwhen the work is in a project): each row carries its id, length in seconds, frame and project.scenewith a scene's id shows which of its shots have a clip, in shot order, as links, not ids: take the ids fromlibrary(kind=video, the scene'sproject_id) orsearch, which finds a render by its prompt's words.- Show the person the ids and the order you intend, and get a yes before
joining. The order given to
assemble_clipsis the order in the video.
Trim
trim_clip with ref, start and end (seconds, inside the clip's length)
and a title. The new clip keeps the source's own sound.
Join
assemble_clips with clips (2 to 20 ids, in order; one may repeat),
transition cut (the default) or crossfade with crossfade_s (0.1 to 2
seconds, at most half the shortest clip), and a title. music is an
optional bed under the clips' own sound: an audio asset:<id> from library
with kind=audio, uploaded in the studio's editor (upload_link takes
pictures and clips, not audio). Clips of different shapes are refused unless
letterbox is true, which fits them inside the first clip's frame with black
bars; reformatting them to one shape first is usually better. project_id
files the result in a project. The result is a new gen:<id> and an editable
cut in the studio's editor.
Reformat
reformat with ref, aspect (9:16, 16:9, 1:1 or 4:5) and fit: pad keeps
the whole picture with black where the shapes differ (the default); crop fills
the frame and keeps the middle, and is refused when the two shapes are too far
apart. One call per shape wanted. platform-delivery says which shape each
platform takes.
Hand over
share_link with the ref and hours (default 24, at most 168). Give the
link to the person in the chat, never to a page or a form: anyone holding it
can download the file until it expires.
Jobs
trim_clip, assemble_clips and reformat run in the background and return
a job_id. Poll job with wait=15; call again while it is still running.
Its result names the new gen:<id>. Jobs live in memory: if job says it is
gone, library (newest first) shows whether the result landed.
A worked example
Person: "Join the three shots of scene 403 with a soft crossfade, make a square version and send me the file."
scene403 shows three shots, each with a clip.librarykind=video with the scene's project gives their ids, newest first: gen:912, gen:911, gen:910. Put them back in shot order and show them; yes.assemble_clipsclips=[gen:910, gen:911, gen:912], transition=crossfade, crossfade_s=0.5, title="Scene 403 cut".jobwith wait=15 until done: gen:913.reformatref=gen:913, aspect=1:1, fit=pad, title="Scene 403 square".jobuntil done: gen:914.share_linkref=gen:914: "Here is the square cut, good for 24 hours: . The three shots and the 9:16 cut are still in your library."
Do not
- Never say a result is ready until
jobsays done orlibrarylists it. - Never pass a URL as a ref; ids come from
libraryorsearch, neverscene. - A refusal (a range outside the clip, shapes too far apart to crop, a music id that is not audio, more than twenty clips) comes back in words: repeat it and change the call. Never retry the identical call.
- Never promise a clip that has not been rendered; that is price-and-render.
- Downloads
- Security audit
- Pass
- Last updated
- 2w ago
- Current version
- v1.0.0
- License
- MIT-0
