语音合成 ElevenLabs TTS

SKILL.md

---
name: dlazy-elevenlabs-tts
version: 1.3.4
description: "ElevenLabs eleven_v3 text-to-speech with 12 curated multilingual voices and stability/similarity/style controls. Great for dubbing, audiobooks, and character dialog. Before picking a voice, you can search for the right one via elevenlabs-search. ElevenLabs eleven_v3 文本转语音，提供 12 种精选英文/多语种音色，支持稳定性、相似度、风格控制。适合配音、有声内容与角色对话。选择音色前，可以从 elevenlabs-search 检索合适的音色。"
metadata: {"clawdbot":{"emoji":"🤖","requires":{"bins":["npm","npx"]},"install":"npm install -g @dlazy/cli@1.2.3","installAlternative":"npx @dlazy/cli@1.2.3","homepage":"https://github.com/dlazy-ai/cli","source":"https://github.com/dlazy-ai/cli","author":"dlazyai","license":"see-repo","npm":"https://www.npmjs.com/package/@dlazy/cli","configLocation":"~/.dlazy/config.json","apiEndpoints":["api.dlazy.com","files.dlazy.com"]},"openclaw":{"systemPrompt":"When invoking this skill, use dlazy elevenlabs-tts -h for help."}}
---

# 语音合成 ElevenLabs TTS

[English](./SKILL.md) · [中文](./SKILL-cn.md)


ElevenLabs eleven_v3 text-to-speech with 12 curated multilingual voices and stability/similarity/style controls. Great for dubbing, audiobooks, and character dialog. Before picking a voice, you can search for the right one via elevenlabs-search.

## Trigger Keywords

- elevenlabs-tts

## Authentication

All requests require a dLazy API key. The recommended way to authenticate is:

```bash
dlazy login
```

This runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config — no manual copy/paste required.

### Alternative: Set the Key Manually

If you already have an API key, you can save it directly:

```bash
dlazy auth set YOUR_API_KEY
```

The CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\.dlazy\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable.

### Getting Your API Key Manually

1. Sign in or create an account at [dlazy.com](https://dlazy.com)
2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)
3. Copy the key shown in the API Key section

Each key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard.

## About & Provenance

- **CLI source code**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)
- **Maintainer**: dlazyai
- **npm package**: `@dlazy/cli` (pinned to `1.2.3` in this skill's install spec)
- **Homepage**: [dlazy.com](https://dlazy.com)

You can install on demand without persisting a global binary by running:

```bash
npx @dlazy/cli@1.2.3 <command>
```

Or, if you prefer a global install, the skill's `metadata.clawdbot.install` field declares the exact pinned version (`npm install -g @dlazy/cli@1.2.3`). Review the GitHub source before installing.

## How It Works

This skill is a thin client over the dLazy hosted API. When you invoke it:

- Prompts and parameters you provide are sent to the dLazy API endpoint (`api.dlazy.com`) for inference.
- Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (`files.dlazy.com`) so the model can read them — the same flow as any cloud-based generation API.
- Generated output URLs returned by the API are hosted on `files.dlazy.com`.

This is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See [dlazy.com](https://dlazy.com) for the full service terms.

## Usage

**CRITICAL INSTRUCTION FOR AGENT**:
Execute `dlazy elevenlabs-tts` to get the result.

```bash
dlazy elevenlabs-tts -h

Options:
  --prompt [prompt]                    Prompt
  --use_custom_voice [use_custom_voice]Use Custom Voice [default: false]
  --custom_voice_id [custom_voice_id]  Custom Voice ID (click search to browse the library or paste a voice_id) [only when use_custom_voice="true"]
  --voice_language [voice_language]    Voice Language [default: multilingual] (choices: "multilingual")
  --voiceId [voiceId]                  Voice ID Options depend on "voice_language". when voice_language="multilingual": 21m00Tcm4TlvDq8ikWAM (Rachel · 知性女声), EXAVITQu4vr4xnSDxMaL (Sarah · 年轻女声), AZnzlk1XvdvUeBnXmlld (Domi · 自信女声), MF3mGyEYCl7XYWbV9V6O (Elli · 甜美女声), ThT5KcBeYPX3keUQqHPh (Dorothy · 温柔女声), ErXwobaYiN019PkySvjV (Antoni · 沉稳男声), TxGEqnHWrfWFTfGW9XjX (Josh · 年轻男声), VR6AewLTigWG4xSOukaG (Arnold · 清晰男声), pNInz6obpgDQGcFmaJgB (Adam · 深沉男声), yoZ06aMxZJJ28mfd3POQ (Sam · 沙哑男声), onwK4e9ZLuTAKqWW03F9 (Daniel · 英伦男声), pqHfZKP75CvOlQylNhV4 (Bill · 中年男声) [default: 21m00Tcm4TlvDq8ikWAM] [options depend on --voice_language; voice_language=multilingual: 21m00Tcm4TlvDq8ikWAM (Rachel · 知性女声), EXAVITQu4vr4xnSDxMaL (Sarah · 年轻女声), AZnzlk1XvdvUeBnXmlld (Domi · 自信女声), MF3mGyEYCl7XYWbV9V6O (Elli · 甜美女声), ThT5KcBeYPX3keUQqHPh (Dorothy · 温柔女声), ErXwobaYiN019PkySvjV (Antoni · 沉稳男声), TxGEqnHWrfWFTfGW9XjX (Josh · 年轻男声), VR6AewLTigWG4xSOukaG (Arnold · 清晰男声), pNInz6obpgDQGcFmaJgB (Adam · 深沉男声), yoZ06aMxZJJ28mfd3POQ (Sam · 沙哑男声), onwK4e9ZLuTAKqWW03F9 (Daniel · 英伦男声), pqHfZKP75CvOlQylNhV4 (Bill · 中年男声)] [only when use_custom_voice="false"]
  --stability [stability]              Stability [default: 0.5]
  --similarity_boost [similarity_boost]Similarity Boost [default: 0.75]
  --style [style]                      Style [default: 0]
  --dry-run                            Print payload + cost estimate without calling API
  --no-wait                            Return generateId immediately for async tasks
  --timeout <seconds>                  Max seconds to wait for async completion (default: "1800")
  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)
  -h, --help                           display help for command
```

> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.

## Output Format

```json
{
  "ok": true,
  "result": {
    "tool": "elevenlabs-tts",
    "modelId": "elevenlabs-tts",
    "outputs": [
      {
        "type": "image",
        "id": "o_xxxxxxxx",
        "url": "https://files.dlazy.com/result.png",
        "mimeType": "image/png"
      }
    ]
  }
}
```

> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.

## Examples

```bash
dlazy elevenlabs-tts --prompt 'prompt content'
```

## Error Handling

| Code | Error Type                         | Example Message                                                                                                          |
| ---- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| 401  | Unauthorized (No API Key)          | `ok: false, code: "unauthorized", message: "API key is missing or invalid"`                                                              |
| 501  | Missing required parameter         | `error: required option '--prompt <prompt>' not specified`                                                              |
| 502  | Local file read error              | `Error: Image file/Video file not found: C:\path\to\your\file`                                                          |
| 503  | API request failed (no balance)    | `ok: false, code: "insufficient_balance"` |
| 503  | API request failed (server error)  | `HTTP status code error (500 server crash)`                                                                             |
| 504  | Asynchronous task execution failed | `=== Generation Failed ===` / `{Specific error reason returned by backend, for example "Prompt violates safety policy"}` |

> **AGENT CRITICAL INSTRUCTION**: 
> 1. If the execution result returns `code: "insufficient_balance"`, you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: [https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)
> 2. If the execution result returns `code: "unauthorized"` or indicates missing API key, you MUST inform the user to get their API key from [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) and save it using `dlazy auth set <key>` and resume the task.

## Tips

Visit https://dlazy.com for more information.