Subclip Local Asset Creation
Create or revise local visuals and import them as native media
Subclip Local Asset Creation
For music or songs, use $subclip-music-generation or $subclip-songwriting and the first-party generate_music tool. Music is an Audio asset; do not create image projects or use speech synthesis for it.
You may create images (or video and audio) with ANY provider you have access to: your own image generation (for example Codex image generation, or a Grok bot), a local tool, or a model you call yourself. Subclip's cloud generation ($subclip-image-generation, which uses the user's AI credits and cloud storage) is optional. Use it when the user asks for Subclip generation or when its models are clearly the best fit; otherwise generate with what you have and import the result.
Asset creation happens locally; timeline placement happens through Subclip.
- Inspect the canvas aspect ratio and the user's visual request.
- Use the best locally available image-generation or image-editing skill/tool. It does not need to be a Subclip skill.
- Save every result as a real file. Anywhere you can write is fine: you do not need to write inside the project. Use PNG, JPEG, or WebP for stills. Give files descriptive, revisioned names such as
warm-paper-background-v1.png. - Never overwrite an existing generated or imported source. A requested revision creates
v2,v3, and so on, preserving rollback and comparison. - Import it with
import_external_media. Pass exactly one ofpath(an absolute file path on the computer running Subclip),url(a public https link) orbase64(inline content, up to 64 MB, for when you cannot share a path), plusstartTimeand optionallydurationSeconds. It works for images, video and audio, validates the file, copies it into the project and creates a normal MediaPanel file and native timeline item.import_generated_media_to_timelineremains available for files already inside the project workspace and is the tool forreplaceItemId(below). - For a revision of an existing timeline visual, put the new file inside the project workspace and call
import_generated_media_to_timelinewithreplaceItemId. This swaps the source while preserving that item's timing, position, crop, size, roundness, opacity, and other manual controls. - Seek to the edited time and inspect the composed frame. If the user dislikes a color, background, or image, edit the local source into a new revision and import/replace again.
Do not use HTML, CSS, SVG markup embedded as code, TSX, or a separate Remotion composition as a shortcut for an ordinary image or background. Do not claim a generated asset is editable pixel-by-pixel inside Subclip; it is editable as a normal media layer, while semantic image revisions are made locally and re-imported.
For generative changes to clip content (objects, colors, environment), route to $subclip-video-generation and discover flux-video-edit. Use ordinary timeline tools for trims/reframes. Talking portraits route to $subclip-avatar-generation; Avatar IV needs portrait AND supplied speech audio.
Let the creator choose
When several results could work (images, a clip, an AI output), show them before importing: $subclip-asset-options (get_asset_options, preview_asset). One numbered options sheet lets the creator answer "number 3" without any project being open.
- Downloads
- 75All time
- Security audit
- Review
- Last updated
- 2d ago
- Current version
- v1.0.0
- License
- MIT-0
