cartesia
Cartesia text-to-speech: synthesize speech audio and browse voices. Trigger phrases: cartesia, text to speech, TTS, synthesize voice, voiceover.
- License 许可
- MIT
- 最近更新
- 2026-11-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- cartesia
- tagline
- Generate spoken audio from text with Cartesia's Sonic models (40+ languages) and browse the Cartesia voice library. Reach for this when the user wants narration, voiceovers, or spoken-audio files produced from a script.
- metadata
- { "includeInPrompt": true }
- description
- Cartesia text-to-speech: synthesize speech audio and browse voices. Trigger phrases: cartesia, text to speech, TTS, synthesize voice, voiceover.
- catalog_auth
- API key via the secure credential flow
- catalog_hosts
- [ "api.cartesia.ai" ]
02 资源文件 1
- 脚本bin/cartesia.py5.6 KB
03 SKILL.md 正文
Cartesia
Purpose
Generate spoken audio from text with Cartesia's Sonic models (40+ languages) and browse the Cartesia voice library. Reach for this when the user wants narration, voiceovers, or spoken-audio files produced from a script.
Tooling
All commands go through bin/cartesia.py. Every request automatically sends the required date header Cartesia-Version: 2026-08-14.
bin/cartesia.py auth
# {"ok": true, "voices": 60} on success
bin/cartesia.py voices
# list available voices (id, name, language)
bin/cartesia.py voice-get --id <VOICE_ID>
# details for a single voice
bin/cartesia.py tts --text "Hello world" --voice-id <VOICE_ID> --out narration.wav
# synthesize speech to a local WAV file; prints the saved path
bin/cartesia.py tts --text "Bonjour le monde" --voice-id <VOICE_ID> \
--language fr --model-id sonic-3 --out fr.wav
Notes:
ttsreturns audio binary. The CLI writes it to--out(defaultcartesia-output.wav) and prints the resulting path.- Streaming TTS (
POST /tts/sse) and the WebSocket TTS/STT surfaces are real-time and outside CLI scope.
Auth
- Provider id:
cartesia(credential is collected ascustom.cartesia) - Collection: Cartesia API key (
sk_car_...) via the secure credential flow (credentials.request_api_access); create one at play.cartesia.ai/keys - Allowed hosts:
api.cartesia.ai - Connect placement:
bearer_header(the key goes inAuthorization: Bearer <key>) - The API also requires the date header
Cartesia-Version: 2026-08-14on every request; the CLI sends it for you. - Status check:
bin/cartesia.py auth
Operating Rules
- TTS synthesis is credit-metered. Every
ttscall spends Cartesia credits, so synthesize only what the user asked for and batch long scripts into as few calls as possible. - Voice creation and voice cloning are confirmation-gated: confirm with the user before creating or cloning any voice. This draft CLI does not ship a clone command; use the Cartesia dashboard or SDK for cloning.
- Never use API keys in client-side code. The connector only ever handles the surrogate, never the raw key.
- The CLI pins
Cartesia-Version: 2026-08-14. Treat a version bump like a dependency upgrade and do not change the date casually.
Files
- SKILL.md
- bin/cartesia.py
Maturity
🧪 Draft: written from Cartesia's public API docs with header and paths cross-checked against official docs at build time; not yet live-tested end-to-end. Voice create/clone and pronunciation dictionaries are not yet in the CLI.
04 同仓库更多 Skills
web-scrape
Turn web pages into LLM-ready markdown via the Firecrawl API (renders JS, anti-bot handling). Use when browser_open/fetch fails on JS-heavy pages, or when you need clean markdown/structured extraction from a site. Requires FIRECRAWL_API_KEY.
design-taste-frontend
tasteskill v2, the anti-slop frontend skill. Art direction for websites, distilled from a study of 247 curated gallery sites (One Page Love, Awwwards Sites of the Day). Deals researched directions (idea, composition, type, palette, photographs, section blueprints) from a library, enforces a strict no-slop house style with a real-browser inspector, and runs a look-and-fix loop on screenshots. Use this whenever you build, design, redesign, restyle, polish or review a landing page, marketing site, portfolio, product page, one-pager, hero or any public-facing web page, in any stack (HTML/CSS, React, Next.js, Vue, Svelte, Astro, Tailwind) — also when the user says a page looks generic, templated, "AI-made", sloppy, or asks to make it look designed, premium, award-level or less like every other site. Not for dashboards or app screens.
test-driven-development
Use when implementing any feature or bugfix, before writing implementation code
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
requesting-code-review
Use when completing tasks, implementing major features, or before merging to verify work meets requirements
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).