@byte_fluffy/nexra-sdk 0.1.0-alpha.25 → 0.1.0-alpha.27

package/README.md

@@ -37,6 +37,43 @@ available from `@byte_fluffy/nexra-sdk/media`.
 The default API base URL is `https://api.nexra-ai.com/v1`. When overriding
 `baseUrl`, include the `/v1` API prefix.
 
+## Private ElevenLabs voices
+
+Voice design uses `elevenlabs/eleven_multilingual_ttv_v2`, with exactly one prompt
+and one script content part. Preview IDs remain in `task.output.previews`; the
+corresponding audio is returned in the ordered persisted `task.assets` list.
+
+```ts
+const design = await nexra.run("elevenlabs/eleven_multilingual_ttv_v2", {
+  content: [
+    { type: "text", role: "prompt", text: "A warm, clear and natural narrator voice." },
+    { type: "text", role: "script", text: previewScript },
+  ],
+}, { idempotencyKey: designKey });
+const creation = await nexra.voices.create({
+  name: "Narrator",
+  source: { kind: "design", taskId: design.task.id, previewId: selectedPreviewId },
+}, { idempotencyKey: saveKey });
+await nexra.tasks.wait(creation.taskId);
+const voice = await nexra.voices.get(creation.voice.id);
+```
+
+Cloning is a voice-resource operation, not a separate vendor model. Upload owned
+audio through `nexra.assets.upload`, then call `nexra.voices.create` with
+`source: { kind: "clone", samples: [sample.id] }`. The service accepts one to five
+stored audio samples totaling at most 25 MiB. Retain the sample IDs and the same
+idempotency key when retrying a creation.
+
+`nexra.voices.list` and `get` read current authenticated resource state. Only an
+active voice can be used for `elevenlabs/eleven_multilingual_v2` speech, using its
+public `voice_` ID. Creation and synthesis settle separately; creation does not
+imply verification or support for renewal, deletion, or voice conversion.
+
+Applications using a shared API key must enforce their own end-user ownership
+before reading or consuming a resource; API-key ownership covers the Nexra
+account, not an application's individual users. Published model choices are
+available through `nexra.models.resources(modelId, resource)`.
+
 Static catalog APIs are also available from `@byte_fluffy/nexra-sdk/catalog`.
 Exact non-negative decimal helpers are available from
 `@byte_fluffy/nexra-sdk/decimal`.

package/dist/catalog.d.ts

@@ -1,5 +1,5 @@
-import { H as HttpTransport, N as NexraSalePriceList, C as CreateNexraQuoteRequest, a as NexraQuote, b as CreateNexraDisplayQuoteBatchRequest, c as NexraDisplayQuoteBatch, d as NexraCatalogRevision, e as NexraModelSpec, f as NexraModelSpecFilter } from './media-geometry-Bo6ukeIQ.js';
-export { M as MediaGeometryField, g as MediaGeometryProjection, h as NexraBillingCurrency, i as NexraModelEndpointSpec, j as NexraModelOperation, k as NexraSalePrice, l as NexraSettlement, U as UnifiedMediaGeometry, m as applyMediaGeometry, n as decodeMediaGeometry, o as encodeMediaGeometry, p as projectMediaGeometry } from './media-geometry-Bo6ukeIQ.js';
+import { H as HttpTransport, N as NexraSalePriceList, C as CreateNexraQuoteRequest, a as NexraQuote, b as CreateNexraDisplayQuoteBatchRequest, c as NexraDisplayQuoteBatch, d as NexraCatalogRevision, e as NexraModelSpec, f as NexraModelSpecFilter } from './media-geometry-B7ip-nrA.js';
+export { M as MediaGeometryField, g as MediaGeometryProjection, h as NexraBillingCurrency, i as NexraModelEndpointSpec, j as NexraModelOperation, k as NexraSalePrice, l as NexraSettlement, U as UnifiedMediaGeometry, m as applyMediaGeometry, n as decodeMediaGeometry, o as encodeMediaGeometry, p as projectMediaGeometry } from './media-geometry-B7ip-nrA.js';
 import './json-Drjj1OKl.js';
 
 declare class CatalogClient {

package/dist/catalog.js

@@ -6,8 +6,8 @@ import {
   getModelSpec,
   listModelSpecs,
   projectMediaGeometry
-} from "./chunk-RKIOP6VA.js";
-import "./chunk-OPHFEY7Z.js";
+} from "./chunk-N622DGTD.js";
+import "./chunk-YQXMWTSV.js";
 export {
   CatalogClient,
   applyMediaGeometry,