videodraft 0.25.2 → 0.27.0

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 CHANGED
@@ -46,6 +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, 5 credits per 1000 chars
49
50
  videodraft generate music "minimal ambient, 60 BPM" --download bgm.mp3
50
51
  videodraft generate sound-effect "cinematic whoosh, sub hit" --duration 3 --download sfx.mp3
51
52
  videodraft generate dialogue --line "elevenlabs-kPzsL2i3teMYv0FxEYQ6:Ready?" --line "elevenlabs-s3TPKV1kjDlVtZbl4Ksh:Let's go." --download dialogue.mp3
@@ -91,11 +92,12 @@ Asset I/O is part of the asset workflow: `videodraft upload`, `videodraft downlo
91
92
 
92
93
  ### 3D model generation and rigging
93
94
 
94
- 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 adds 20 credits and 4k adds 40. 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
96
 
96
97
  ```bash
97
98
  videodraft models 3d --json
98
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
99
101
  videodraft generate 3d --model meshy-7 --ref ./character.png --download
100
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
101
103
  videodraft wait JOB_ID --download ./media/3d --json
@@ -125,17 +127,14 @@ videodraft create "<idea>" --ar 9:16 # idea → script → visual ass
125
127
  videodraft shots <project> --grid --estimate # preview the cost…
126
128
  videodraft shots <project> --grid # …then batch-generate every shot image
127
129
  videodraft produce <project> # voiceovers + captions + production timeline
130
+ videodraft produce <project> --voice-mode turbo # ElevenLabs narration on Eleven v4 Turbo (faster, cheaper)
128
131
  videodraft produce <project> --mode full_video # one Seedance video per scene
129
132
  videodraft export <project> --download final.mp4
130
133
  ```
131
134
 
132
- Seedance 2.x allows real people by default, the same as AI Studio: Byteplus
133
- first, a submit-time Fal fallback, and Fal's higher tier-specific rate. Pass
134
- `--no-allow-real-people` for the lower Byteplus-only rate when nothing in the
135
- job is a real identifiable person. If an opted-out request returns
136
- `SEEDANCE_REAL_PERSON_OPT_IN_REQUIRED`, estimate the higher rate and retry once
137
- with `--allow-real-people`. Do not loop if real people were already allowed;
138
- 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.
139
138
 
140
139
  ## Commands
141
140
 
@@ -223,3 +222,7 @@ const me = await client.callTool("whoami");
223
222
  ## License
224
223
 
225
224
  MIT © VideoDraft
225
+
226
+ Ideogram 4.5 (`ideogram-v4.5`) replaces the visible Ideogram 4.0 entry and stays Tier 2. Quality prices per image: low 3 credits, medium 6 (default), high 22; very_low 1 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 costs 5-10 credits at 1K, 20-24 at 2K and 77-82 at 4K, set by the 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" : realPersonHint,
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);