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 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, 5 credits per 1000 chars
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 allows real people by default, the same as AI Studio: Byteplus
135
- first, a submit-time Fal fallback, and Fal's higher tier-specific rate. Pass
136
- `--no-allow-real-people` for the lower Byteplus-only rate when nothing in the
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 costs 1 VideoDraft credit on the platform Fal account and
162
- 0 credits with Fal BYOK. `--estimate` checks the active account without creating
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" : 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);