@shop-os/modelkit 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -9,6 +9,21 @@ header in the release PR.
 
 ## [Unreleased]
 
+## [0.10.0] - Unreleased
+
+ElevenLabs direct: text to speech and instant voice cloning on our own ElevenLabs account (ENG-3400).
+
+### Added
+- Adapter `elevenlabs` for the ElevenLabs REST API (`https://api.elevenlabs.io`, base-url override `endpoints.elevenlabs`). Key `elevenlabs` from `ELEVENLABS_API_KEY`, with the `ENTERPRISE_` / `SLOOSH_` prefixes; a sloosh call without `SLOOSH_ELEVENLABS_API_KEY` fails with `auth`. fal's ElevenLabs rows run on fal's account and cannot see a cloned voice, so custom voices need the direct API.
+- Speech row `elevenlabs-v4-direct` (`model_id` `eleven_v4`): the 18 previewed premade voices under their ElevenLabs voice ids (taken from the preview URLs; default Sarah `EXAVITQu4vr4xnSDxMaL`), the v4 languages, the ElevenLabs MP3 `output_format`s (default `mp3_44100_128`), 10,000 characters, `capabilities.customVoices`. Usage is one `images`-unit call, like the other speech rows.
+- Voice-clone row `elevenlabs-ivc` (Instant Voice Clone, `POST /v1/voices/add`): 1-25 samples, `enhance` sent as `remove_background_noise`, transcripts ignored (IVC takes none), a `designSignature` refused with `unsupported_option` (a Fish design cannot be kept on ElevenLabs). Returns `voiceId` and `state` `trained`, or `created` while ElevenLabs holds the voice for verification. Usage unit `requests`. `deleteVoice` on the same row (`DELETE /v1/voices/{id}`).
+
+### Notes
+- Both rows ship with `exposure: []`: callable by id, listed nowhere, unpriced. fal's ElevenLabs rows keep their exposure.
+- `createVoice` retries only a 429: after a 5xx ElevenLabs may already hold the voice. A full voice library (`voice_limit_reached`) is `provider_rejected` with ElevenLabs' message; a 401 `quota_exceeded` is `provider_billing`, not `auth`.
+- `deleteVoice` follows Fish: a first-attempt "not found" (404, or a 400 `voice_not_found` / `voice_does_not_exist`) is `provider_rejected`, since a voice of another account looks unknown too; after a failed attempt of the same call it counts as deleted.
+- A kit before 0.10.0 refuses the `elevenlabs` adapter id, so these rows stay invisible to consumers that have not upgraded.
+
 ## [0.9.0] - Unreleased
 
 Fish Audio: text to speech, voice cloning and voice design (ENG-3400).

package/README.md

@@ -52,6 +52,7 @@ const transcript = await kit.transcribe({ model: "elevenlabs-scribe-v2", source:
 const { voiceId } = await kit.createVoice({ model: "fish-voice-clone", title, samples: [{ audio: { url } }] }, { tier });
 const mine = await kit.generateSpeech({ model: "fish-s2.1-pro", text, customVoice: voiceId }, { tier });
 await kit.deleteVoice({ model: "fish-voice-clone", voiceId }, { tier });
+// ElevenLabs works the same way: clone on `elevenlabs-ivc`, speak on `elevenlabs-v4-direct`.
 
 const clip = await kit.prepareMediaPart(
     "gemini-2.5-flash",
@@ -350,7 +351,7 @@ the app's secrets, not a Cloudflare gateway token.
 
 ## Adapters
 
-`ai-sdk-text`, `google-image`, `openai-image`, `google-genai` (Veo, Omni with `delivery: "uri"`, Lyria 3, Files API media parts), `ark` (Seedream, Seedance), `fal`, `replicate` (images, video, Lyria 2, MMAudio), `prodia`, `higgsfield`, `xai-video`, `luma` (Uni images, Ray 3.2 video via the Agents API; `LUMA_API_KEY`, base-url override `endpoints.luma`), `fish` (Fish Audio speech, `createVoice` / `designVoice` / `deleteVoice`; `FISH_AUDIO_API_KEY`, base-url override `endpoints.fish`). See `src/adapters/`.
+`ai-sdk-text`, `google-image`, `openai-image`, `google-genai` (Veo, Omni with `delivery: "uri"`, Lyria 3, Files API media parts), `ark` (Seedream, Seedance), `fal`, `replicate` (images, video, Lyria 2, MMAudio), `prodia`, `higgsfield`, `xai-video`, `luma` (Uni images, Ray 3.2 video via the Agents API; `LUMA_API_KEY`, base-url override `endpoints.luma`), `fish` (Fish Audio speech, `createVoice` / `designVoice` / `deleteVoice`; `FISH_AUDIO_API_KEY`, base-url override `endpoints.fish`), `elevenlabs` (direct ElevenLabs speech, `createVoice` / `deleteVoice`; `ELEVENLABS_API_KEY`, base-url override `endpoints.elevenlabs`). See `src/adapters/`.
 
 ## Not in the package