@clipwright/sdk 0.23.0 → 0.24.0

package/CHANGELOG.md

@@ -16,6 +16,45 @@ a customer reading it should not miss what appeared in the product. Like *Server
 they are live from the day the web app was deployed, not from the package release they are
 listed under.
 
+## [0.24.0] - 2026-10-03
+
+A second speech model, `gemini-3.8-flash-tts`, with thirty voices of its own and a sample of each in English and
+Russian. Nothing changes unless you name the model or one of its voices. The CLI and the MCP server accept the new
+`tts_model` value from this release on.
+
+### Added
+
+- `tts_model` accepts `gemini-3.8-flash-tts`, a speech model of a second vendor. Nothing changes unless you name it:
+  every default stays as it was, and Russian speech without `tts_model` still uses `eleven_v4`. The model speaks only
+  its own voices: without `voice`, `kore` for a female actor and `charon` otherwise. It reads Russian stress marks,
+  and it gets the text with `<break time="…" />` tags cut, which the response names in a warning. Its script limit is
+  5,000 characters. The price per finished second is the same as on every other model. (clipwright#453)
+- `voice` accepts the thirty voices of `gemini-3.8-flash-tts` by name: `kore`, `puck`, `zephyr` and the rest, as
+  `list_voices` returns them. Naming one selects that model without `tts_model`, and the quote names the model.
+  `clipwright voices` prints the model on the line of such a voice. (clipwright#453)
+- *Server-side:* `list_voices` returns those thirty voices after the presets as entries of kind `model_voice`. Each
+  names one model in `model` and `supported_models`, has no `language`, and carries `gender` only where it is known:
+  `kore` is female and `charon` is male. The filters `model=gemini-3.8-flash-tts`, `language=ru` and `language=en`
+  find them; any other language does not. (clipwright#453)
+- *Server-side:* each of those thirty voices carries `preview_url`, a short sample spoken by that voice on its model.
+  The sample is in English; a request filtered by `language=ru` gets the Russian one. `clipwright voices` prints the
+  link under the voice, as it does for every other voice with a sample. (clipwright#453)
+- *Server-side:* with `gemini-3.8-flash-tts` the API refuses a preset or catalog `voice`, `voice_id`, `captions=true`,
+  `segments` and `inserts` before any charge: the model does not speak the preset and catalog voices and returns no
+  word timings. It refuses the same when a voice names the model instead of `tts_model`, and it refuses one of the
+  model's voices next to any other `tts_model`. Each refusal names what to pass instead. `list_voices` lists the
+  model in `models[]` with the languages `en` and `ru`; no preset or catalog voice names it in `supported_models`.
+  (clipwright#453)
+- *Server-side:* a warning about stress marks on `eleven_flash_v2_5` or `eleven_turbo_v2_5` names only the models
+  that speak the voice of the run: with an explicit `voice` or `voice_id` these are `eleven_v3` and `eleven_v4`.
+  (clipwright#453)
+- *Server-side:* the quote and the reserve for a Russian script on `gemini-3.8-flash-tts` assume 2.2 words per second,
+  the pace measured on its two default voices: 153 Russian words are quoted at 70 seconds and 2,100 credits. A script
+  in Latin letters on this model is quoted at 2.6 words per second, as on every other model. The charge follows the
+  measured duration. (clipwright#453)
+- *Dashboard:* the Privacy Policy, the Cookie Policy and the AI disclosure page name the speech provider of a run
+  that chooses this model. (clipwright#453)
+
 ## [0.23.0] - 2026-10-02
 
 Russian speech moves to `eleven_v4`: the server names it by default, and the client texts say which voices speak it.

package/README.md

@@ -32,11 +32,19 @@ refuse a mismatched `script`/`brief` before sending anything.
 `preview_url` that expires in an hour. Pass a voice's `name` as `voice`;
 `language` is a filter only, since any voice speaks any supported language.
 
+The list holds the presets, the thirty voices of the speech model
+`gemini-3.8-flash-tts` (`kind: "model_voice"`) and the catalog. A `model_voice`
+voice has no language of its own: `language: "en"` and `language: "ru"` find it,
+and its sample is in English unless you ask for `language: "ru"`. Naming such a
+voice makes the run speak `gemini-3.8-flash-tts` without `tts_model`. That model
+speaks only its own voices and refuses `captions: true` before any charge.
+
 Without `voice` or `voice_id`, the voice follows the actor's gender: `sarah` for
 a woman, `george` for a man. `actor_id` brings its catalog gender; with `image`,
 pass `actor_gender` (`"female"` or `"male"`). An `image` without `actor_gender`
 gets `george` and a warning. `actor_gender` next to `actor_id` or without
-`image` is refused before any charge.
+`image` is refused before any charge. With `tts_model: "gemini-3.8-flash-tts"`
+the defaults are `kore` for a woman and `charon` otherwise.
 
 Requires `CLIPWRIGHT_CLIENT_ID`, or a writable `~/.clipwright/` for the SDK to
 create one on first use. It fails loudly rather than generating a throwaway id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipwright/sdk",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "TypeScript client for the Clipwright UGC video API",
   "license": "MIT",
   "author": "Dimantika Sp. z o.o.",
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "zod": "^4.4.3",
-    "@clipwright/core": "0.23.0"
+    "@clipwright/core": "0.24.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.1"