videodraft 0.26.0 → 0.27.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -11
- package/dist/client.js +1 -9
- package/dist/index.js +168 -92
- package/package.json +1 -1
- package/skills/index.json +11 -11
- package/skills/videodraft/SKILL.md +28 -28
- package/skills/videodraft/references/3d.md +1 -1
- package/skills/videodraft/references/editor.md +2 -1
- package/skills/videodraft/references/examples.md +1 -1
- package/skills/videodraft/references/models.md +64 -51
- package/skills/videodraft/references/pipeline.md +2 -2
package/README.md
CHANGED
|
@@ -46,7 +46,7 @@ videodraft generate video --model gemini-omni-1.1-flash --previous-interaction-i
|
|
|
46
46
|
videodraft generate audio "Read this in a calm documentary voice" --voice vivi_mixed_en_zh_ja_es_id --download narration.mp3
|
|
47
47
|
videodraft generate audio "Extend @Audio1 with soft rain" --ref-audio ./opening.wav --download extended.wav --format wav
|
|
48
48
|
videodraft generate voiceover "Welcome to VideoDraft" --download welcome.mp3
|
|
49
|
-
videodraft generate voiceover "Welcome to VideoDraft" --mode turbo --download welcome.mp3 # Eleven v4 Turbo: faster
|
|
49
|
+
videodraft generate voiceover "Welcome to VideoDraft" --mode turbo --download welcome.mp3 # Eleven v4 Turbo: faster and cheaper
|
|
50
50
|
videodraft generate music "minimal ambient, 60 BPM" --download bgm.mp3
|
|
51
51
|
videodraft generate sound-effect "cinematic whoosh, sub hit" --duration 3 --download sfx.mp3
|
|
52
52
|
videodraft generate dialogue --line "elevenlabs-kPzsL2i3teMYv0FxEYQ6:Ready?" --line "elevenlabs-s3TPKV1kjDlVtZbl4Ksh:Let's go." --download dialogue.mp3
|
|
@@ -92,11 +92,12 @@ Asset I/O is part of the asset workflow: `videodraft upload`, `videodraft downlo
|
|
|
92
92
|
|
|
93
93
|
### 3D model generation and rigging
|
|
94
94
|
|
|
95
|
-
Meshy 7 and Tripo H3.1 support text, image, and multi-image inputs through Fal. Saved 3D assets are independent of AI Studio sessions. Inspect the live catalog for each endpoint's exact options, view order, limits, default settings, output formats, and pricing:
|
|
95
|
+
Meshy 7.1 (`--model meshy-7`, or `meshy-7.1`) and Tripo H3.1 support text, image, and multi-image inputs through Fal. Meshy's `geometry_resolution` option sets the geometry detail: text and image take `standard`, `2k` (the default) or `4k`, and multi-image takes `standard` (the default) or `2k`. 2k and 4k cost more. Saved 3D assets are independent of AI Studio sessions. Inspect the live catalog for each endpoint's exact options, view order, limits, default settings, output formats, and pricing:
|
|
96
96
|
|
|
97
97
|
```bash
|
|
98
98
|
videodraft models 3d --json
|
|
99
99
|
videodraft generate 3d "a weathered brass telescope" --model meshy-7 --estimate
|
|
100
|
+
videodraft generate 3d "a weathered brass telescope" --model meshy-7 --option geometry_resolution=4k --estimate
|
|
100
101
|
videodraft generate 3d --model meshy-7 --ref ./character.png --download
|
|
101
102
|
videodraft generate 3d --model tripo-h3.1 --input-mode multi_image --ref ./front.png --ref ./left.png --ref ./back.png --ref ./right.png --options @model-options.json --no-wait --json
|
|
102
103
|
videodraft wait JOB_ID --download ./media/3d --json
|
|
@@ -131,13 +132,9 @@ videodraft produce <project> --mode full_video # one Seedance video per scene
|
|
|
131
132
|
videodraft export <project> --download final.mp4
|
|
132
133
|
```
|
|
133
134
|
|
|
134
|
-
Seedance 2.x
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
job is a real identifiable person. If an opted-out request returns
|
|
138
|
-
`SEEDANCE_REAL_PERSON_OPT_IN_REQUIRED`, estimate the higher rate and retry once
|
|
139
|
-
with `--allow-real-people`. Do not loop if real people were already allowed;
|
|
140
|
-
late Byteplus output refusals are refunded but cannot be rerouted.
|
|
135
|
+
Seedance 2.x has no real-people option. A video that can't be made at the
|
|
136
|
+
listed rate, usually one showing a real person, costs a higher rate, and the
|
|
137
|
+
difference is charged before it starts.
|
|
141
138
|
|
|
142
139
|
## Commands
|
|
143
140
|
|
|
@@ -158,8 +155,8 @@ late Byteplus output refusals are refunded but cannot be rerouted.
|
|
|
158
155
|
|
|
159
156
|
`call` reaches **every** VideoDraft API tool (the full MCP catalog), including ones without a curated command — new platform features work in the CLI the day they ship.
|
|
160
157
|
|
|
161
|
-
Kling voice creation
|
|
162
|
-
|
|
158
|
+
Kling voice creation has a small charge on the platform Fal account and is free
|
|
159
|
+
with Fal BYOK. `--estimate` checks the active account without creating
|
|
163
160
|
a voice. Samples must be MP3, WAV, MP4, or MOV, 5-30 seconds, and no larger
|
|
164
161
|
than 50 MB. Voice IDs are opaque strings scoped to the Fal account that created
|
|
165
162
|
them; keep a `voice_id` inside its image-backed or video-backed element so the binding is preserved.
|
|
@@ -225,3 +222,7 @@ const me = await client.callTool("whoami");
|
|
|
225
222
|
## License
|
|
226
223
|
|
|
227
224
|
MIT © VideoDraft
|
|
225
|
+
|
|
226
|
+
Ideogram 4.5 (`ideogram-v4.5`) replaces the visible Ideogram 4.0 entry and stays Tier 2. Quality: low, medium (default) or high, priced per image; very_low for regular edits. Supports 1-8 outputs, 1K/2K, seed, a source plus four additional references (three with a mask), regular/high edit precision, and text-to-image prompt expansion. MCP uses `source_image`, `reference_images`, `mask_url`, `edit_precision`, `enable_prompt_expansion`, `image_width`, and `image_height`. CLI equivalents are `--source-image`, repeatable `--ref`, `--mask`, `--edit-precision`, `--prompt-expansion`, `--image-width`, and `--image-height`. Precise/masked edits require Auto size with no resolution or custom dimensions. Masks match source dimensions and contain both black edit regions and white preserved regions. Quotes for very_low require the source/reference count (`reference_image_count` or `--ref-images`). Legacy 4.0 jobs retain their original backend support.
|
|
227
|
+
|
|
228
|
+
FLUX 3 image (`flux-3-image`, not the `flux-3` video model) is Tier 2. It generates and edits with up to 10 references, 1-4 outputs, 1K/2K/4K (default 1K), prompt expansion (default on) and 14 aspect ratios plus auto. Each image is priced by output size (resolution and ratio); auto is quoted at the tier's highest price. Without an aspect ratio, a new image is 16:9 and an edit follows its first reference. No seed. MCP uses `reference_images`, `num_images`, `resolution`, `aspect_ratio` and `enable_prompt_expansion`; the CLI uses `--ref`, `--num`, `--resolution`, `--ar` and `--prompt-expansion`.
|
package/dist/client.js
CHANGED
|
@@ -45,24 +45,16 @@ var ToolError = class extends CliError {
|
|
|
45
45
|
toolName;
|
|
46
46
|
constructor(toolName, message, data) {
|
|
47
47
|
const isCredits = CREDIT_ERROR_RE.test(message);
|
|
48
|
-
const realPersonHint = seedanceRealPersonRetryHint(data);
|
|
49
48
|
super(
|
|
50
49
|
message,
|
|
51
50
|
isCredits ? EXIT.CREDITS : EXIT.ERROR,
|
|
52
|
-
isCredits ? "Check your balance with `videodraft credits` or top up at https://app.videodraft.ai/pricing" :
|
|
51
|
+
isCredits ? "Check your balance with `videodraft credits` or top up at https://app.videodraft.ai/pricing" : void 0,
|
|
53
52
|
data
|
|
54
53
|
);
|
|
55
54
|
this.name = "ToolError";
|
|
56
55
|
this.toolName = toolName;
|
|
57
56
|
}
|
|
58
57
|
};
|
|
59
|
-
function seedanceRealPersonRetryHint(value) {
|
|
60
|
-
const payload = value;
|
|
61
|
-
if (payload?.code !== "SEEDANCE_REAL_PERSON_OPT_IN_REQUIRED" && payload?.retry_with?.allow_real_people !== true) {
|
|
62
|
-
return void 0;
|
|
63
|
-
}
|
|
64
|
-
return "Retry this Seedance request once with --allow-real-people (or simply without --no-allow-real-people). This uses higher Fal-tier pricing.";
|
|
65
|
-
}
|
|
66
58
|
var TimeoutError = class extends CliError {
|
|
67
59
|
constructor(message) {
|
|
68
60
|
super(message, EXIT.ERROR);
|