Kitta Audio CLI
从实际 CLI Schema 和帮助生成的参数、默认值与约束。
对应 CLI 版本: 0.1.0.
本页由 scripts/generate-audio-cli-docs.mjs 生成。参数描述保留 CLI 原始英文；教程提供中文操作说明。
实际 API 必填字段与 CLI 工作流选项分开列出。TTS 的 text 可通过 --text-file 或 --text - 提供；二进制下载必须指定 --output。默认值为 — 表示 CLI 没有设置默认值，服务端可能有自己的默认规则。
POST 命令上存在 --idempotency-key 不代表所有接口都保证去重。仅幂等 TTS 创建具有相应自动重试策略。请阅读恢复指南。
恢复与计费
kitta auth status --help kitta auth status --schema HTTP: GET /api/open/v1/profile. Retry: read.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —
kitta audio models list --help kitta audio models list --schema HTTP: GET /api/open/v3/speech/tts/capabilities. Retry: read.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —
kitta audio voices list --help kitta audio voices list --schema HTTP: GET /api/open/v3/voices. Retry: read.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —--page <value> page —--page-size <value> pageSize —--search <value> search —--include-personal includePersonal —--no-include-personal Set includePersonal to false —--all Fetch all pages —--max-pages <count> Maximum pages to fetch 100--language <code> Filter fetched voices by primary or supported language —
Flag Required Schema --page no {"type":"integer","minimum":1,"default":1}--page-size no {"type":"integer","minimum":1,"maximum":100,"default":20}--search no {"type":"string"}--include-personal no {"type":"boolean","default":false}
kitta audio voices get --help kitta audio voices get --schema HTTP: GET /api/open/v3/voices/{voiceId}. Retry: read.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —--voice <value> Required. voiceId —
Flag Required Schema --voice yes {"type":"string"}
kitta audio tts --help kitta audio tts --schema HTTP: POST /api/open/v3/speech/tts/jobs. Retry: idempotent.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —--text <value> Required. text —--voice <value> Required. voiceId —--model <value> Public TTS engine model id. When omitted, the platform uses the default engine for the selected voice provider, such as fishaudio-s21pro-flash for Kitta AI voices. —--format <value> format —--speed <value> speed —--volume <value> volume —--pitch <value> pitch —--stability <value> stability —--similarity <value> similarity —--language <value> language —--emotion <value> emotion —--instruction <value> instruction —--text-normalization textNormalization —--no-text-normalization Set textNormalization to false —--filter-emoji Experimental, disabled by default. Currently removes only selected decorative kaomoji, not graphical emoji. Independent of textNormalization. Ambiguous text is preserved. Billing uses filtered text; an empty result returns 400 before charging. —--no-filter-emoji Set filterEmoji to false —--idempotency-key <key> Stable submission key; retry policy is shown by --schema —--output <path> Save audio to a new file —--text-file <path> Read UTF-8 text —--wait Wait for downloadable audio —--wait-timeout <seconds> Maximum local wait 600
Flag Required Schema --text yes {"type":"string","minLength":1,"maxLength":10000}--voice yes {"type":"string","minLength":1}--model no {"type":"string","enum":["fishaudio-s21pro","fishaudio-s2pro","fishaudio-s1","fishaudio-s21pro-flash","fishaudio-s2pro-enterprise","minimax-2.8-turbo","minimax-2.8-hd","minimax-2.6-turbo","minimax-2.6-hd","qwen3-tts-flash","qwen-audio-3.0-tts-plus","qwen-audio-3.0-tts-flash","cosyvoice-v3-flash","doubao-tts-2.0","elevenlabs-flash-v2.5","elevenlabs-multilingual-v2"],"description":"Public TTS engine model id. When omitted, the platform uses the default engine for the selected voice provider, such as fishaudio-s21pro-flash for Kitta AI voices."}--format no {"type":"string","enum":["mp3","wav"],"default":"mp3"}--speed no {"type":"number","minimum":0.5,"maximum":2,"default":1}--volume no {"type":"number","minimum":-20,"maximum":20,"default":0}--pitch no {"type":"number","minimum":-12,"maximum":12}--stability no {"type":"number","minimum":0.5,"maximum":1.5}--similarity no {"type":"number","minimum":0.5,"maximum":1.5}--language no {"type":"string","minLength":1,"maxLength":64}--emotion no {"type":"string","minLength":1,"maxLength":64}--instruction no {"type":"string","minLength":1,"maxLength":1600}--text-normalization no {"type":"boolean"}--filter-emoji no {"type":"boolean","default":false,"description":"Experimental, disabled by default. Currently removes only selected decorative kaomoji, not graphical emoji. Independent of textNormalization. Ambiguous text is preserved. Billing uses filtered text; an empty result returns 400 before charging."}
kitta audio jobs list --help kitta audio jobs list --schema HTTP: GET /api/open/v3/speech/tts/jobs. Retry: read.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —--page <value> page —--limit <value> limit —--status <value> status —--created-after <value> createdAfter —--all Fetch all pages —--max-pages <count> Maximum pages to fetch 100
Flag Required Schema --page no {"type":"integer","minimum":1,"default":1}--limit no {"type":"integer","minimum":1,"maximum":100,"default":20}--status no {"type":"string","enum":["pending","processing","success","partial_fail","fail"]}--created-after no {"type":"string","format":"date-time"}
kitta audio jobs get --help kitta audio jobs get --schema HTTP: GET /api/open/v3/speech/tts/jobs/{jobId}. Retry: read.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —--job <value> Required. jobId —
Flag Required Schema --job yes {"type":"string"}
kitta audio jobs download --help kitta audio jobs download --schema HTTP: GET /api/open/v3/speech/tts/jobs/{jobId}/audio. Retry: read.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —--job <value> Required. jobId —--download download —--no-download Set download to false —--output <path> Save audio to a new file —
Flag Required Schema --job yes {"type":"string"}--download no {"type":"boolean","default":false}
kitta audio transcribe --help kitta audio transcribe --schema HTTP: POST /api/open/v1/speech/transcriptions. Retry: never.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —--audio-url <value> Required. audio_url —--language <value> language —--ignore-timestamps ignore_timestamps —--no-ignore-timestamps Set ignore_timestamps to false —--file-name <value> file_name —--idempotency-key <key> Stable submission key; retry policy is shown by --schema —
Flag Required Schema --audio-url yes {"type":"string","format":"uri"}--language no {"type":"string"}--ignore-timestamps no {"type":"boolean","default":false}--file-name no {"type":"string"}
kitta audio voices clone --help kitta audio voices clone --schema HTTP: POST /api/open/v1/voices. Retry: never.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —--name <value> Required. Voice display name. —--audio-file <values...> Required. Audio files used to create the voice model. —--description <value> description —--reference-text <value> Optional transcript text. —--visibility <value> visibility —--languages <value> JSON string array of language codes, such as ["zh","en"]. —--idempotency-key <key> Stable submission key; retry policy is shown by --schema —
Flag Required Schema --name yes {"type":"string","description":"Voice display name."}--audio-file yes {"type":"array","items":{"type":"string","format":"binary"},"description":"Audio files used to create the voice model."}--description no {"type":"string"}--reference-text no {"type":"string","description":"Optional transcript text."}--visibility no {"type":"string","enum":["private","public"]}--languages no {"type":"string","description":"JSON string array of language codes, such as [\"zh\",\"en\"]."}
kitta audio voices design --help kitta audio voices design --schema HTTP: POST /api/open/v1/voice-designs. Retry: never.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —--prompt <value> Required. prompt —--preview-text <value> Required. previewText —--providers <values...> providers —--idempotency-key <key> Stable submission key; retry policy is shown by --schema —
Flag Required Schema --prompt yes {"type":"string"}--preview-text yes {"type":"string"}--providers no {"type":"array","minItems":1,"maxItems":2,"items":{"type":"string","enum":["fishaudio","minimax"]},"default":["fishaudio","minimax"]}
kitta audio voices save --help kitta audio voices save --schema HTTP: POST /api/open/v1/voice-designs/{designId}/voices. Retry: never.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —--design <value> Required. designId —--candidate <value> Required. candidateId —--name <value> Required. name —--description <value> description —--visibility <value> visibility —--language <value> Primary language of the saved voice. Defaults to the request language. —--reference-text <value> referenceText —--idempotency-key <key> Stable submission key; retry policy is shown by --schema —
Flag Required Schema --design yes {"type":"string"}--candidate yes {"type":"string"}--name yes {"type":"string","maxLength":100}--description no {"type":"string","maxLength":500}--visibility no {"type":"string","enum":["private","public"],"default":"private"}--language no {"type":"string","enum":["en","zh","ru","zh-hant","es","ja","ko","fr","ar","de","pt","hi","tr","it","id","th","pl","tl","uk","nl","ms","el","ro","vi"],"description":"Primary language of the saved voice. Defaults to the request language."}--reference-text no {"type":"string","maxLength":150}
kitta audio voices preview --help kitta audio voices preview --schema HTTP: GET /api/open/v1/voice-designs/{designId}/candidates/{candidateId}/audio. Retry: read.
选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--schema Show the offline command contract —--dry-run Validate and preview without network or state writes —--design <value> Required. designId —--candidate <value> Required. candidateId —--output <path> Save audio to a new file —
Flag Required Schema --design yes {"type":"string"}--candidate yes {"type":"string"}
kitta audio jobs wait --help kitta audio jobs wait --schema 选项 说明 CLI 默认值 -V, --version output the version number —--json Machine-readable JSON output —--api-url <origin> Kitta API origin https://kittaai.com--timeout <seconds> Per-request timeout 30--job <id> Required. TTS task ID —--wait-timeout <seconds> Maximum local wait 600--output <path> Download once ready —--schema Describe this workflow offline —--dry-run Validate and preview without network access —
Usage: kitta auth login [options] Validate an API key and store it in the system credential manager Options: -h, --help display help for command Usage: kitta auth logout [options] Remove the stored credential for this API origin Options: -h, --help display help for command Usage: kitta skills generate [options] Write version-matched CLI reference and audio workflows offline Options: --output-dir <path> New skill directory (default: ".agents/skills/kitta-audio") -h, --help display help for command login 读取隐藏输入中的 API Key；logout 仅删除当前服务地址的钥匙串凭据。skills generate 离线创建新目录，不覆盖已有目录。