videodraft 0.4.1 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "videodraft",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "Official VideoDraft CLI — create AI videos, images and audio from your terminal. Agent-friendly: --json everywhere, stable exit codes, async job polling.",
   "license": "MIT",
   "type": "module",

package/skills/index.json

@@ -3,27 +3,27 @@
   "skills": [
     {
       "name": "videodraft",
-      "description": "Create AI videos, images, voiceovers, music, sound effects, dialogue, dubbing, storyboards, avatar videos, media upscales and product/ad videos with VideoDraft. Use when the user mentions VideoDraft, or asks to generate/make a video, video ad, explainer, storyboard, talking-head/avatar video, AI image, voiceover/TTS, background music, sound effects, dialogue audio, voice changing, dubbing, or image/video enhancement and upscaling, including batch/programmatic video generation in scripts or CI. Works via the `videodraft` CLI (preferred in terminals) or the VideoDraft MCP connector.",
+      "description": "Create AI videos, images, Seed Audio, voiceovers, music, sound effects, dialogue, dubbing, storyboards, avatar videos, media upscales and product/ad videos with VideoDraft. Use when the user mentions VideoDraft, or asks to generate/make a video, video ad, explainer, storyboard, talking-head/avatar video, AI image, prompt-driven or reference-driven audio, voiceover/TTS, background music, sound effects, dialogue audio, voice changing, dubbing, or image/video enhancement and upscaling, including batch/programmatic video generation in scripts or CI. Works via the `videodraft` CLI (preferred in terminals) or the VideoDraft MCP connector.",
       "files": [
         {
           "path": "references/examples.md",
-          "sha256": "91cc9aa5a49c34e9a73fdfd224eaf5ce46588c22bd72a951810ae73544efed25",
-          "bytes": 6254
+          "sha256": "5d1bfb72d125db97a0e018643b83a1be6dae60d1ad622ff99ede01d4d916f6a7",
+          "bytes": 6390
         },
         {
           "path": "references/models.md",
-          "sha256": "a871eeec1dc1cc164718f1f52ea40cc90510c2f4c3b71fb57bd6a25981ad06a0",
-          "bytes": 17138
+          "sha256": "2c2fe6a0f5235f6cf6aa7e73181bc37e57a7f6acb48bffc8807eba543ac9068a",
+          "bytes": 18025
         },
         {
           "path": "references/pipeline.md",
-          "sha256": "054109a6ab556bcace1ff843b001afe9bc3a0aac389667e979ac7b77a7200a50",
-          "bytes": 10644
+          "sha256": "f584a668497a7e8fb619c42c3450268f9b365dd11c72d5bc2655002fa0151536",
+          "bytes": 10810
         },
         {
           "path": "SKILL.md",
-          "sha256": "8796e157a835f17edcd8c8345c2668042fdcd793781eace573a570825b6440c6",
-          "bytes": 15094
+          "sha256": "cc80f773350858bc4ef430ebd8cd4e6e55c1a98101c759edea39da443118ab43",
+          "bytes": 16074
         }
       ]
     }

package/skills/videodraft/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: videodraft
-description: Create AI videos, images, voiceovers, music, sound effects, dialogue, dubbing, storyboards, avatar videos, media upscales and product/ad videos with VideoDraft. Use when the user mentions VideoDraft, or asks to generate/make a video, video ad, explainer, storyboard, talking-head/avatar video, AI image, voiceover/TTS, background music, sound effects, dialogue audio, voice changing, dubbing, or image/video enhancement and upscaling, including batch/programmatic video generation in scripts or CI. Works via the `videodraft` CLI (preferred in terminals) or the VideoDraft MCP connector.
+description: Create AI videos, images, Seed Audio, voiceovers, music, sound effects, dialogue, dubbing, storyboards, avatar videos, media upscales and product/ad videos with VideoDraft. Use when the user mentions VideoDraft, or asks to generate/make a video, video ad, explainer, storyboard, talking-head/avatar video, AI image, prompt-driven or reference-driven audio, voiceover/TTS, background music, sound effects, dialogue audio, voice changing, dubbing, or image/video enhancement and upscaling, including batch/programmatic video generation in scripts or CI. Works via the `videodraft` CLI (preferred in terminals) or the VideoDraft MCP connector.
 ---
 
 # VideoDraft
 
 VideoDraft is an AI video creation platform where asset generation is the priority lane:
 
-- **Asset generation**: standalone images, video clips, voiceovers, music, sound effects, dialogue, voice-changed audio, dubbed media, upscales, and image descriptions. This is the fastest and most important lane. Treat these as complete deliverables when the user asks for assets.
+- **Asset generation**: standalone images, video clips, Seed Audio, voiceovers, music, sound effects, dialogue, voice-changed audio, dubbed media, upscales, and image descriptions. This is the fastest and most important lane. Treat these as complete deliverables when the user asks for assets.
 - **Asset I/O**: upload local files, download outputs, auto-upload local references, and save generated media where the user can see it.
 - **Project production**: idea → script → storyboard (scenes + shot images) → project data → production timeline → exported MP4. Use it for a multi-scene video, story, ad, explainer, storyboard, editable timeline, or final export, even when the user does not say "project." A script-only request also creates a script-stage project but stops at the script.
 
@@ -59,6 +59,7 @@ If the user names a model, use it when compatible. If it cannot handle the reque
 
 **Audio and utilities:**
 
+- Use Seed Audio 1.0 for open-ended text-to-audio, speech/music/sound synthesis, voice conditioning, or prompt-driven editing with up to three audio references or one image. Use `videodraft generate audio`. Reference clips are `@Audio1`, `@Audio2`, and `@Audio3` in array order. There is no duration input. Output is up to two minutes and settles at 19 credits per actual minute, with up to 38 credits reserved during generation. The CLI automatically retries transient responses with one operation key. To recover after the CLI process itself is interrupted, set `--idempotency-key <uuid>` on the original command and reuse it.
 - Prefer ElevenLabs for voiceover, dialogue, voice changing, dubbing, and sound effects. Honor an explicitly selected supported TTS voice/provider. Use Lyria for instrumental music and ElevenLabs Music for vocals, lyrics, or exact timing.
 - Talking head/presenter: choose by source. Use managed `avatar create` then `avatar render` when the user wants a reusable avatar record and bundled speech. Use `avatar fabric` for a one-off portrait plus text or existing audio. Use `avatar lipsync` when both the source video and replacement audio already exist.
 - Enhancement: use Topaz image/video upscaling only when the content is already correct. Use image 1x for cleanup, 2x by default, 4x when justified; use video 2x by default. Edit or regenerate creative errors.
@@ -79,11 +80,11 @@ Do not call `videodraft credits` before routine generations. Paid endpoints vali
 
 For expensive work, estimate with `--estimate` or `videodraft costs`, state the selected model/settings/cost, and get a go-ahead. This matters most for shot-image batches, long or high-resolution video, AI Production, and paid audio batches. Honor the user's confirmation preference for the session.
 
-`videodraft models image|video` lists the live image and video catalogs with supported inputs. Video entries are grouped as `generation`, `video_edit`, `motion_control`, `avatar_lipsync`, and `upscale`, and each reports the exact tool. Use `videodraft models video --category video_edit` to narrow the list. `videodraft models audio` lists Google Lyria and ElevenLabs audio/media tools, while `videodraft models voices` lists TTS voices. Consult them instead of guessing capabilities.
+`videodraft models image|video` lists the live image and video catalogs with supported inputs. Video entries are grouped as `generation`, `video_edit`, `motion_control`, `avatar_lipsync`, and `upscale`, and each reports the exact tool. Use `videodraft models video --category video_edit` to narrow the list. `videodraft models audio` lists Seed Audio, Google Lyria, and ElevenLabs audio/media tools, while `videodraft models voices` lists TTS voices. Consult them instead of guessing capabilities.
 
 ## Async jobs
 
-Image/video generation is asynchronous: commands submit a job and **wait by default**, printing output URLs (and saving files with `--download`). In scripts/CI prefer explicit control:
+Image/video generation is asynchronous: commands submit a job and **wait by default**, printing output URLs (and saving files with `--download`). Large downloaded images also get a downscaled copy in `previews/` next to them (the `preview` field / "inspect via preview" line in the output) — **look at the preview, deliver the original**; viewing full-resolution images bloats the chat permanently. In scripts/CI prefer explicit control:
 
 ```bash
 JOB=$(videodraft generate image "..." --no-wait --json | jq -r .job_id)
@@ -130,7 +131,7 @@ videodraft produce <project_id>                 # voiceovers + captions + produc
 videodraft export <project_id> --download final.mp4
 ```
 
-Optional between produce and export: per-shot motion clips (`videodraft generate video ... --project <id>` then place it with `videodraft attach <project> --scene N --shot M --media <url|file> --type video --duration <s>`), music (`videodraft generate music "..." --attach <project_id>`), and standalone audio assets (`generate sound-effect`, `generate dialogue`, `generate voice-changer`, `generate dub`). Details, per-step tools and editing rules: [references/pipeline.md](references/pipeline.md).
+Optional between produce and export: per-shot motion clips (`videodraft generate video ... --project <id>` then place it with `videodraft attach <project> --scene N --shot M --media <url|file> --type video --duration <s>`), music (`videodraft generate music "..." --attach <project_id>`), and standalone audio assets (`generate audio`, `generate sound-effect`, `generate dialogue`, `generate voice-changer`, `generate dub`). Details, per-step tools and editing rules: [references/pipeline.md](references/pipeline.md).
 
 Avatar/talking-head videos use dedicated commands. For a reusable managed avatar, obtain or generate a clear portrait → `videodraft avatar script` when needed → `videodraft avatar create` → `videodraft avatar render --resolution 720p`. For a one-off portrait, use `videodraft avatar fabric <portrait> --text "..."` or `--audio <file>`. For an existing video plus replacement audio, use `videodraft avatar lipsync <video> --audio <file>`. Managed script/creation is bundled/free; direct Fabric, Sync, the managed Fabric render, and optional portrait generation/upscaling are paid. Confirm expensive steps first.
 

package/skills/videodraft/references/examples.md

@@ -39,6 +39,7 @@ videodraft shots "$PROJECT" --grid --estimate          # show the user the cost;
 videodraft shots "$PROJECT" --grid
 videodraft produce "$PROJECT"
 videodraft generate music "minimal ambient, warm pads, 60 BPM" --attach "$PROJECT"
+videodraft generate audio "Extend @Audio1 into a 20-second transition" --ref-audio ./intro.wav --format wav --download ./transition.wav
 videodraft export "$PROJECT" --download solace-launch.mp4
 ```
 

package/skills/videodraft/references/models.md

@@ -75,6 +75,7 @@ Kling O3 and Wan 2.7 Ref/Edit are dual-mode cards. `videodraft edit video` uses
 
 ### Audio
 
+- **Seed Audio 1.0**: use `videodraft generate audio` for open-ended speech, sound, music, or prompt-driven audio editing. It accepts up to three audio references or one image. Address audio references as `@Audio1`, `@Audio2`, and `@Audio3`. Preset and custom cloned voice IDs are supported. Output is up to 120 seconds. There is no requested-duration input. The CLI automatically retries transient responses with one idempotency key. To recover after the CLI process itself is interrupted, set `--idempotency-key <uuid>` on the original command and reuse it.
 - **Voiceover/TTS**: prefer ElevenLabs. Brittney is the platform default voice; under ElevenLabs BYOK, use a compatible voice from the user's account. Honor another supported voice/provider when the user explicitly selects it.
 - **Dialogue, voice changing, and dubbing**: ElevenLabs only.
 - **Sound effects**: ElevenLabs Sound Effects only.
@@ -132,6 +133,7 @@ Direct Fabric text/audio and Sync Labs do not use the managed avatar record. The
 - Sync Labs Lipsync 2: 5 credits per verified audio second.
 - Voiceover TTS: 10 credits per 1000 characters for standard voices, 30 per 1000 for cloned `custom-*` voices (min 1, pro-rated); applies to standalone voiceovers AND per-scene narration during `produce`. Silent tracks are free. Voice cloning itself is a flat 150 credits per clone.
 - Lyria music: flat per track, 10 credits (clip) / 15 credits (pro).
+- Seed Audio 1.0: 19 credits per actual output minute, prorated and rounded up to a whole credit. VideoDraft reserves the 120-second maximum of 38 credits and refunds the unused portion after generation. Fal BYOK is free.
 - ElevenLabs audio: sound effects are per second, dialogue is per character, music/voice-changer/dubbing are per started minute. Voice changer and dubbing reject source media above 300s in the current synchronous flow.
 - Upscales: priced by scale and source size.
 
@@ -141,6 +143,7 @@ Quote before spending:
 videodraft costs gemini-omni-flash --type video --duration 8 --resolution 720p --audio
 videodraft costs seedance-2 --type video --duration 15 --resolution 720p --quality standard --audio
 videodraft costs elevenlabs-dubbing --type audio --duration 60
+videodraft costs seed-audio-1.0 --type audio --duration 60 # scenario only; model controls actual length
 videodraft costs elevenlabs-dialogue --type audio --chars 350
 videodraft costs voiceover --type audio --chars 800    # TTS: 10 cr / 1000 chars
 videodraft generate video "..." --model gemini-omni-flash --estimate # same quote, inline

package/skills/videodraft/references/pipeline.md

@@ -18,6 +18,7 @@ Use direct asset tools for standalone images, clips, audio, upscales, and descri
 | Motion clip for a shot                  | `videodraft generate video --project <id>`                                  | `generate_video`                           |
 | Attach a finished clip to the timeline  | `videodraft attach <project> --scene N --shot M --media <url> --type video` | `attach_media_to_shot`                     |
 | Background music                        | `videodraft generate music --attach <project>`                              | `generate_music` / `set_background_music`  |
+| General or reference-driven audio       | `videodraft generate audio "..."`                                          | `generate_audio`                           |
 | Sound effect                            | `videodraft generate sound-effect "..."`                                    | `generate_sound_effect`                    |
 | Dialogue audio                          | `videodraft generate dialogue --line "voice:text"`                          | `generate_dialogue`                        |
 | Voice changer                           | `videodraft generate voice-changer <audio>`                                 | `change_voice`                             |