Uydi Voice Design & Clone

Uydi Voice enables an AI agent to design custom voices, clone a user's authorized voice sample, synthesize narration, and produce multi-voice Voice Canvas projects with the Uydi voice platform (https://uydi.com). Use it when a user asks to create or describe a voice, clone their own voice from a recording, convert text to speech, generate narration audio, arrange multiple speakers or languages into one audio file, list or manage Uydi voices, check Uydi credits, or review synthesis history. It requires Node.js 18+ and a one-time OAuth approval in the user's browser.

Uydi Voice

Use the Uydi voice platform from any agent: voice design (text description → new voice), voice cloning (audio sample → digital voice), text-to-speech synthesis, and multi-voice Voice Canvas production, all through a single zero-dependency CLI script.

Requirements

• Node.js 18 or newer (node --version) — the script uses only built-in modules.
• A Uydi account (register free at https://uydi.com).
• All commands run as: node scripts/uydi.mjs <command> (relative to this skill directory).

What the skill can do

• Design a new AI voice from a natural-language brief and generate a WAV preview.
• Clone a voice from a 10–20 second WAV, MP3, or M4A sample when the user owns the voice or has explicit permission.
• Synthesize speech from text with a selected Uydi voice and save a WAV file.
• Produce a Voice Canvas from an ordered sequence of language-aware voices, scripts, and pauses, then download one continuous 24 kHz WAV.
• Manage the authenticated account's voice list, synthesis history, and credit balance.

First-time login (one-time, needs the user)

Authentication uses OAuth; the token is stored in ~/.uydi/credentials.json (mode 600) and stays valid for 365 days.

bash

node scripts/uydi.mjs login

• Default: opens the browser for the user to approve access (authorization code + PKCE with a local loopback callback).
• Headless / no browser: automatically falls back to a device code flow — the terminal prints a URL (https://uydi.com/activate) and an 8-character code (XXXX-XXXX) for the user to enter on any device. Use login --device to force this mode.
• IMPORTANT: the login must be completed by the human user in a browser. If a command fails with a 401 / "Not logged in" error, ask the user to run the login and wait.

Commands

bash

node scripts/uydi.mjs whoami                # current account
node scripts/uydi.mjs credits               # credit balance and pricing
node scripts/uydi.mjs voices                # list voices (id, kind, name, status)
node scripts/uydi.mjs delete-voice <id>     # delete a voice permanently

# Design a brand-new voice from a text description (costs credits;
# --name, --prompt and --preview-text are all required):
node scripts/uydi.mjs design --name "Warm Narrator" \
  --prompt "A warm, deep male narrator voice, slow pace, documentary style" \
  --preview-text "Hello, this is a preview." -o preview.wav

# Clone a voice from a 10-20s clean speech sample (wav/mp3/m4a, costs credits):
node scripts/uydi.mjs clone --name "My Voice" --file sample.wav

# Synthesize speech with any voice (1 credit / 10 chars, max 2000 chars per run):
node scripts/uydi.mjs tts --voice <voiceId> --text "Text to speak, any language." -o out.wav

node scripts/uydi.mjs history --limit 10    # recent syntheses
node scripts/uydi.mjs logout                # revoke token + delete local credentials

Voice Canvas

bash

node scripts/uydi.mjs system-voices --language en --search narrator
node scripts/uydi.mjs canvas-list
node scripts/uydi.mjs canvas-create --title "Episode 1"
node scripts/uydi.mjs canvas-show <projectId>
node scripts/uydi.mjs canvas-save <projectId> --file canvas.json
node scripts/uydi.mjs canvas-estimate <projectId>
node scripts/uydi.mjs canvas-render <projectId> -o episode-1.wav
node scripts/uydi.mjs canvas-status <renderId> --wait -o episode-1.wav
node scripts/uydi.mjs canvas-renders --limit 10
node scripts/uydi.mjs canvas-delete <projectId>

For the editable JSON schema, language codes, voice selection, optimistic versioning, credit checks, background rendering, and safe retry behavior, read references/voice-canvas.md before using Canvas commands.

Optional flags: --provider qwen|cosyvoice on design/clone (default qwen, the general-purpose multilingual engine; cosyvoice focuses on dialects).

Typical workflows

1. Narration from scratch: design a voice matching the user's description → tts the script text → deliver the WAV file.
2. Speak in the user's own voice: ask for a 10–20 s clean recording → clone → tts with the new voice id.
3. Reuse an existing voice: voices to find the id → tts.
4. Multi-speaker production: choose compatible voices → create a canvas → save the ordered nodes → estimate credits → render and deliver the merged WAV.

Security & trust

• The CLI is a single zero-dependency script (scripts/uydi.mjs, Node.js built-ins only) — fully auditable before running, no install step, no postinstall hooks.
• Downloads can be verified: https://uydi.com/downloads/uydi-voice-skill.zip.sha256 holds the SHA-256 of the official zip (shasum -a 256 -c after download).
• The token only grants access to the user's own Uydi voices/credits; it never touches the account password. The user can revoke it anytime with logout or from the website.
• Approval always happens on uydi.com in the user's browser; the script never asks for or handles the account password.

Notes

• Every design / clone / tts call consumes real credits from the user's account (credits shows pricing). Confirm with the user before large batch synthesis.
• Voice Canvas preview, saving, estimation, reused nodes, merging, playback, and download are free. canvas-render charges only nodes that need newly generated audio. Show the exact estimate first; an explicit request to render is sufficient authorization.
• Voice slots are limited per plan (free: 1 voice, Pro: 5). If design/clone fails with a quota error, list voices with voices and ask the user which one to delete-voice.
• Voice cloning requires the user to own the voice or have explicit permission.
• Output audio is WAV. Text over 2000 characters must be split into multiple tts runs.
• Canvas has no application-level node cap; each node accepts up to 600 characters and a 0–3000 ms pause. Total project text is 2,000 characters on Free and 20,000 on Pro.
• canvas-delete permanently deletes the project and stored audio. Use it only when the user explicitly asks to delete that exact project.
• Set UYDI_BASE_URL to target a different deployment (e.g. a local dev server).

Validation before handoff

1. Run node scripts/uydi.mjs whoami to confirm the intended Uydi account.
2. Run node scripts/uydi.mjs credits before any operation that can consume credits.
3. After design, clone, or tts, confirm that the CLI reports a voice ID or output WAV path, and provide that result to the user.
4. After canvas-render, confirm the render reaches completed, the merged WAV exists, and report its render ID, duration, charged credits, and absolute output path.
5. If a request fails, do not blindly repeat a paid operation. Check history, voices, canvas-show, or canvas-status first and explain the returned error. Reuse the printed Canvas idempotency key when retrying an uncertain render request.

Version history

• 1.1.0 — Adds language-aware Voice Canvas project editing, credit estimation, background rendering, status polling, completed-render history, and WAV download.
• 1.0.1 — Adds the required idempotency header for clone and synthesis requests.
• 1.0.0 — Initial public marketplace release.