Kitta CLI
Parameters, defaults and constraints generated from CLI schemas and help.
CLI version: 0.2.0.
Generated by scripts/generate-audio-cli-docs.mjs from the built CLI and operation contract.
API-required fields are separate from CLI workflow options. TTS text can come from --text-file or --text -. Binary downloads require --output. A default of — means no CLI default; the server may apply its own defaults.
Only commands backed by a server idempotency key expose --idempotency-key. Create operations with retry=idempotent in their schema may retry transient failures. Read the recovery guide.
Recovery and billing
kitta files upload --api-url https://fishaudio.org --help kitta files upload --api-url https://fishaudio.org --schema HTTP: POST /api/open/v1/uploads. Retry: never.
Option Description CLI default -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 —--file <value> Required. file —--type <value> Required. type —
Flag Required Schema --file yes {"type":"string","format":"binary"}--type yes {"type":"string","enum":["audio","image","video"]}
kitta auth status --api-url https://fishaudio.org --help kitta auth status --api-url https://fishaudio.org --schema HTTP: GET /api/open/v1/profile. Retry: read.
Option Description CLI default -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 auth profile update --api-url https://fishaudio.org --help kitta auth profile update --api-url https://fishaudio.org --schema HTTP: POST /api/open/v1/profile. Retry: never.
Option Description CLI default -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 --api-url https://fishaudio.org --help kitta audio models list --api-url https://fishaudio.org --schema HTTP: GET /api/open/v3/speech/tts/capabilities. Retry: read.
Option Description CLI default -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 --api-url https://fishaudio.org --help kitta audio voices list --api-url https://fishaudio.org --schema HTTP: GET /api/open/v3/voices. Retry: read.
Option Description CLI default -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 --api-url https://fishaudio.org --help kitta audio voices get --api-url https://fishaudio.org --schema HTTP: GET /api/open/v3/voices/{voiceId}. Retry: read.
Option Description CLI default -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 --api-url https://fishaudio.org --help kitta audio tts --api-url https://fishaudio.org --schema HTTP: POST /api/open/v3/speech/tts/jobs. Retry: idempotent.
Option Description CLI default -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 Fish Audio 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 binary output 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":["gemini-3.8-flash-tts","gemini-3.8-flash-lite-tts","fishaudio-drama3-preview","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 Fish Audio 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 --api-url https://fishaudio.org --help kitta audio jobs list --api-url https://fishaudio.org --schema HTTP: GET /api/open/v3/speech/tts/jobs. Retry: read.
Option Description CLI default -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 --api-url https://fishaudio.org --help kitta audio jobs get --api-url https://fishaudio.org --schema HTTP: GET /api/open/v3/speech/tts/jobs/{jobId}. Retry: read.
Option Description CLI default -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 --api-url https://fishaudio.org --help kitta audio jobs download --api-url https://fishaudio.org --schema HTTP: GET /api/open/v3/speech/tts/jobs/{jobId}/audio. Retry: read.
Option Description CLI default -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 binary output to a new file —
Flag Required Schema --job yes {"type":"string"}--download no {"type":"boolean","default":false}
kitta audio jobs segment download --api-url https://fishaudio.org --help kitta audio jobs segment download --api-url https://fishaudio.org --schema HTTP: GET /api/open/v3/speech/tts/jobs/{jobId}/segments/{segmentIndex}. Retry: read.
Option Description CLI default -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 —--segment <value> Required. segmentIndex —--output <path> Save binary output to a new file —
Flag Required Schema --job yes {"type":"string"}--segment yes {"type":"integer","minimum":0}
kitta audio transcribe --api-url https://fishaudio.org --help kitta audio transcribe --api-url https://fishaudio.org --schema HTTP: POST /api/open/v1/speech/transcriptions. Retry: never.
Option Description CLI default -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 —
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 --api-url https://fishaudio.org --help kitta audio voices clone --api-url https://fishaudio.org --schema HTTP: POST /api/open/v1/voices. Retry: never.
Option Description CLI default -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"]. —
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 --api-url https://fishaudio.org --help kitta audio voices design --api-url https://fishaudio.org --schema HTTP: POST /api/open/v1/voice-designs. Retry: never.
Option Description CLI default -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 --api-url https://fishaudio.org --help kitta audio voices save --api-url https://fishaudio.org --schema HTTP: POST /api/open/v1/voice-designs/{designId}/voices. Retry: never.
Option Description CLI default -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 --api-url https://fishaudio.org --help kitta audio voices preview --api-url https://fishaudio.org --schema HTTP: GET /api/open/v1/voice-designs/{designId}/candidates/{candidateId}/audio. Retry: read.
Option Description CLI default -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 binary output to a new file —
Flag Required Schema --design yes {"type":"string"}--candidate yes {"type":"string"}
kitta audio voices delete --api-url https://fishaudio.org --help kitta audio voices delete --api-url https://fishaudio.org --schema HTTP: DELETE /api/open/v1/voices/{voiceId}. Retry: never.
Option Description CLI default -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 —--yes Confirm the destructive operation —
Flag Required Schema --voice yes {"type":"string"}
kitta audio voices update --api-url https://fishaudio.org --help kitta audio voices update --api-url https://fishaudio.org --schema HTTP: PATCH /api/open/v1/voices/{voiceId}. Retry: never.
Option Description CLI default -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 —--title <value> title —--description <value> description —--visibility <value> visibility —--language <value> language —
Flag Required Schema --voice yes {"type":"string"}--title no {"type":"string","minLength":1,"maxLength":80}--description no {"type":"string","maxLength":500}--visibility no {"type":"string","enum":["public","private"]}--language no {"type":"string"}
kitta audio personal-voice generate --api-url https://fishaudio.org --help kitta audio personal-voice generate --api-url https://fishaudio.org --schema HTTP: POST /api/open/v1/speech/voice-clone-tts/jobs. Retry: idempotent.
Option Description CLI default -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 —--source-audio-url <value> Required. Customer-owned or authorized reference audio URL downloadable by Fish Audio. —--text <value> Required. text —--voice-name <value> voice_name —--file-name <value> file_name —--model-id <value> model_id —--format <value> format —--speed <value> Platform speaking speed range. Model limits apply; ElevenLabs requires 0.7–1.2. —--volume <value> Platform volume control for engines that support it. ElevenLabs does not apply this field. —--stability <value> Model-specific stability: Fish Audio 0.5–1.5 (default 1); ElevenLabs 0–1 (default 0.5). Other engines do not apply this field. —--similarity <value> Model-specific voice consistency: Fish Audio 0.5–1.5 (default 1); ElevenLabs 0–1 (default 0.75). Other engines do not apply this field. —--pitch <value> Pitch adjustment for MiniMax and Qwen models. —--language <value> language —--emotion <value> emotion —--instruction <value> instruction —--text-normalization text_normalization —--no-text-normalization Set text_normalization to false —--idempotency-key <key> Stable submission key; retry policy is shown by --schema —--output <path> Save binary output to a new file —--wait Wait for a terminal task state —--wait-timeout <seconds> Maximum local wait 600
Flag Required Schema --source-audio-url yes {"type":"string","format":"uri","description":"Customer-owned or authorized reference audio URL downloadable by Fish Audio."}--text yes {"type":"string","minLength":1,"maxLength":5000}--voice-name no {"type":"string","minLength":1,"maxLength":100}--file-name no {"type":"string","minLength":1,"maxLength":255}--model-id no {"type":"string","enum":["fishaudio-drama3-preview","fishaudio-s21pro","fishaudio-s21pro-flash","fishaudio-s2pro","fishaudio-s1"],"default":"fishaudio-s21pro-flash"}--format no {"type":"string","enum":["mp3","wav"],"default":"mp3"}--speed no {"type":"number","minimum":0.5,"maximum":2,"default":1,"description":"Platform speaking speed range. Model limits apply; ElevenLabs requires 0.7–1.2."}--volume no {"type":"number","minimum":-20,"maximum":20,"default":0,"description":"Platform volume control for engines that support it. ElevenLabs does not apply this field."}--stability no {"type":"number","minimum":0,"maximum":1.5,"description":"Model-specific stability: Fish Audio 0.5–1.5 (default 1); ElevenLabs 0–1 (default 0.5). Other engines do not apply this field."}--similarity no {"type":"number","minimum":0,"maximum":1.5,"description":"Model-specific voice consistency: Fish Audio 0.5–1.5 (default 1); ElevenLabs 0–1 (default 0.75). Other engines do not apply this field."}--pitch no {"type":"number","minimum":-12,"maximum":12,"default":0,"description":"Pitch adjustment for MiniMax and Qwen models."}--language no {"type":"string","maxLength":32}--emotion no {"type":"string","maxLength":64}--instruction no {"type":"string","maxLength":1600}--text-normalization no {"type":"boolean","default":true}
kitta audio personal-voice get --api-url https://fishaudio.org --help kitta audio personal-voice get --api-url https://fishaudio.org --schema HTTP: GET /api/open/v1/speech/voice-clone-tts/jobs/{jobId}. Retry: read.
Option Description CLI default -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 models list --api-url https://fishaudio.org --help kitta models list --api-url https://fishaudio.org --schema HTTP: GET /api/open/v1/media/models. Retry: read.
Option Description CLI default -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 —--media-type <value> mediaType —
Flag Required Schema --media-type no {"type":"string","enum":["image","video"]}
kitta image generate --api-url https://fishaudio.org --help kitta image generate --api-url https://fishaudio.org --schema HTTP: POST /api/open/v1/media/images/jobs. Retry: idempotent.
Option Description CLI default -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 —--model <value> model —--image-url <value> image_url —--image-urls <values...> Ordered reference images for edit mode. Do not combine with image_url. Limits depend on the selected model and resolution. —--resolution <value> Use a verified model catalog variant; credits and reference limits vary by resolution. —--mask-url <value> mask_url —--generation-type <value> generation_type —--response-format <value> response_format —--aspect-ratio <value> aspect_ratio —--idempotency-key <key> Stable submission key; retry policy is shown by --schema —--output <path> Save binary output to a new file —--wait Wait for a terminal task state —--wait-timeout <seconds> Maximum local wait 600
Flag Required Schema --prompt yes {"type":"string"}--model no {"type":"string"}--image-url no {"type":"string","format":"uri"}--image-urls no {"type":"array","minItems":1,"maxItems":4,"items":{"type":"string","format":"uri"},"description":"Ordered reference images for edit mode. Do not combine with image_url. Limits depend on the selected model and resolution."}--resolution no {"type":"string","enum":["1k","2k","4k"],"default":"1k","description":"Use a verified model catalog variant; credits and reference limits vary by resolution."}--mask-url no {"type":"string","format":"uri"}--generation-type no {"type":"string","enum":["generate","edit"]}--response-format no {"type":"string","enum":["url","b64_json"]}--aspect-ratio no {"type":"string"}
kitta image jobs list --api-url https://fishaudio.org --help kitta image jobs list --api-url https://fishaudio.org --schema HTTP: GET /api/open/v1/media/images/jobs. Retry: read.
Option Description CLI default -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 —--generation-type <value> generation_type —--all Fetch all pages —--max-pages <count> Maximum pages to fetch 100
Flag Required Schema --page no {"type":"integer","minimum":1,"maximum":10000}--limit no {"type":"integer","minimum":1,"maximum":100}--status no {"type":"string","maxLength":64}--generation-type no {"type":"string","enum":["generate","edit"]}
kitta image jobs get --api-url https://fishaudio.org --help kitta image jobs get --api-url https://fishaudio.org --schema HTTP: GET /api/open/v1/media/images/jobs/{jobId}. Retry: read.
Option Description CLI default -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 video generate --api-url https://fishaudio.org --help kitta video generate --api-url https://fishaudio.org --schema HTTP: POST /api/open/v1/media/videos/jobs. Retry: idempotent.
Option Description CLI default -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 —--model <value> model —--references <values...> references —--size <value> size —--seconds <value> seconds —--watermark watermark —--no-watermark Set watermark to false —--private private —--no-private Set private to false —--idempotency-key <key> Stable submission key; retry policy is shown by --schema —--output <path> Save binary output to a new file —--wait Wait for a terminal task state —--wait-timeout <seconds> Maximum local wait 600
Flag Required Schema --prompt yes {"type":"string"}--model no {"type":"string"}--references no {"type":"array","items":{"type":"object","required":["role","url"],"properties":{"role":{"type":"string","enum":["start_frame","end_frame","reference"]},"url":{"type":"string","format":"uri"}}}}--size no {"type":"string"}--seconds no {"oneOf":[{"type":"string"},{"type":"number"}]}--watermark no {"type":"boolean"}--private no {"type":"boolean"}
kitta video jobs list --api-url https://fishaudio.org --help kitta video jobs list --api-url https://fishaudio.org --schema HTTP: GET /api/open/v1/media/videos/jobs. Retry: read.
Option Description CLI default -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 —--all Fetch all pages —--max-pages <count> Maximum pages to fetch 100
Flag Required Schema --page no {"type":"integer","minimum":1,"maximum":10000}--limit no {"type":"integer","minimum":1,"maximum":100}--status no {"type":"string","maxLength":64}
kitta video jobs get --api-url https://fishaudio.org --help kitta video jobs get --api-url https://fishaudio.org --schema HTTP: GET /api/open/v1/media/videos/jobs/{jobId}. Retry: read.
Option Description CLI default -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 video lip-sync generate --api-url https://fishaudio.org --help kitta video lip-sync generate --api-url https://fishaudio.org --schema HTTP: POST /api/open/v1/media/lip-sync/jobs. Retry: never.
Option Description CLI default -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 —--video-url <value> Required. video_url —--audio-url <value> Required. audio_url —--model <value> model —--video-extension When false, billing uses the shorter video/audio input. When true, billing uses audio duration and the provider extends the video. —--no-video-extension Set video_extension to false —--output <path> Save binary output to a new file —--wait Wait for a terminal task state —--wait-timeout <seconds> Maximum local wait 600
Flag Required Schema --video-url yes {"type":"string","format":"uri"}--audio-url yes {"type":"string","format":"uri"}--model no {"type":["string","null"]}--video-extension no {"type":"boolean","default":false,"description":"When false, billing uses the shorter video/audio input. When true, billing uses audio duration and the provider extends the video."}
kitta video lip-sync jobs list --api-url https://fishaudio.org --help kitta video lip-sync jobs list --api-url https://fishaudio.org --schema HTTP: GET /api/open/v1/media/lip-sync/jobs. Retry: read.
Option Description CLI default -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 —--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":50,"default":10}--status no {"type":"string"}
kitta video lip-sync jobs get --api-url https://fishaudio.org --help kitta video lip-sync jobs get --api-url https://fishaudio.org --schema HTTP: GET /api/open/v1/media/lip-sync/jobs/{jobId}. Retry: read.
Option Description CLI default -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 video dubbing generate --api-url https://fishaudio.org --help kitta video dubbing generate --api-url https://fishaudio.org --schema HTTP: POST /api/open/v1/media/video-dubbing/jobs. Retry: idempotent.
Option Description CLI default -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 —--video-url <value> Required. video_url —--text <value> Required. text —--reference-id <value> Required. Fish Audio voice id —--model-id <value> model_id —--speed <value> Platform speaking speed range. Model limits apply; ElevenLabs requires 0.7–1.2. —--volume <value> Platform volume control for engines that support it. ElevenLabs does not apply this field. —--stability <value> Model-specific stability: Fish Audio 0.5–1.5 (default 1); ElevenLabs 0–1 (default 0.5). Other engines do not apply this field. —--similarity <value> Model-specific voice consistency: Fish Audio 0.5–1.5 (default 1); ElevenLabs 0–1 (default 0.75). Other engines do not apply this field. —--pitch <value> Pitch adjustment for MiniMax and Qwen models. —--language <value> language —--emotion <value> emotion —--instruction <value> instruction —--text-normalization text_normalization —--no-text-normalization Set text_normalization to false —--idempotency-key <key> Stable submission key; retry policy is shown by --schema —--output <path> Save binary output to a new file —--wait Wait for a terminal task state —--wait-timeout <seconds> Maximum local wait 600
Flag Required Schema --video-url yes {"type":"string","format":"uri"}--text yes {"type":"string","minLength":1,"maxLength":5000}--reference-id yes {"type":"string","description":"Fish Audio voice id"}--model-id no {"type":"string","enum":["gemini-3.8-flash-tts","gemini-3.8-flash-lite-tts","fishaudio-drama3-preview","fishaudio-s21pro","fishaudio-s2pro","fishaudio-s1","fishaudio-s21pro-flash","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"]}--speed no {"type":"number","minimum":0.5,"maximum":2,"default":1,"description":"Platform speaking speed range. Model limits apply; ElevenLabs requires 0.7–1.2."}--volume no {"type":"number","minimum":-20,"maximum":20,"default":0,"description":"Platform volume control for engines that support it. ElevenLabs does not apply this field."}--stability no {"type":"number","minimum":0,"maximum":1.5,"description":"Model-specific stability: Fish Audio 0.5–1.5 (default 1); ElevenLabs 0–1 (default 0.5). Other engines do not apply this field."}--similarity no {"type":"number","minimum":0,"maximum":1.5,"description":"Model-specific voice consistency: Fish Audio 0.5–1.5 (default 1); ElevenLabs 0–1 (default 0.75). Other engines do not apply this field."}--pitch no {"type":"number","minimum":-12,"maximum":12,"default":0,"description":"Pitch adjustment for MiniMax and Qwen models."}--language no {"type":"string","maxLength":32}--emotion no {"type":"string","maxLength":64}--instruction no {"type":"string","maxLength":1600}--text-normalization no {"type":"boolean","default":true}
kitta video dubbing jobs get --api-url https://fishaudio.org --help kitta video dubbing jobs get --api-url https://fishaudio.org --schema HTTP: GET /api/open/v1/media/video-dubbing/jobs/{jobId}. Retry: read.
Option Description CLI default -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 wait --api-url https://fishaudio.org --help kitta audio jobs wait --api-url https://fishaudio.org --schema Option Description CLI default -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 —
kitta audio jobs wait --api-url https://fishaudio.org --help kitta audio jobs wait --api-url https://fishaudio.org --schema Option Description CLI default -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. Existing task ID —--wait-timeout <seconds> Maximum local wait 600--output <path> Download the first result artifact to a new file —--schema Describe this workflow offline —--dry-run Validate and preview without network access —
kitta audio jobs wait --api-url https://fishaudio.org --help kitta audio jobs wait --api-url https://fishaudio.org --schema Option Description CLI default -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. Existing task ID —--wait-timeout <seconds> Maximum local wait 600--output <path> Download the first result artifact to a new file —--schema Describe this workflow offline —--dry-run Validate and preview without network access —
kitta audio jobs wait --api-url https://fishaudio.org --help kitta audio jobs wait --api-url https://fishaudio.org --schema Option Description CLI default -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. Existing task ID —--wait-timeout <seconds> Maximum local wait 600--output <path> Download the first result artifact to a new file —--schema Describe this workflow offline —--dry-run Validate and preview without network access —
kitta audio jobs wait --api-url https://fishaudio.org --help kitta audio jobs wait --api-url https://fishaudio.org --schema Option Description CLI default -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. Existing task ID —--wait-timeout <seconds> Maximum local wait 600--output <path> Download the first result artifact to a new file —--schema Describe this workflow offline —--dry-run Validate and preview without network access —
kitta audio jobs wait --api-url https://fishaudio.org --help kitta audio jobs wait --api-url https://fishaudio.org --schema Option Description CLI default -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. Existing task ID —--wait-timeout <seconds> Maximum local wait 600--output <path> Download the first result artifact to a new file —--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 reads an API key from a hidden prompt. Logout removes only the keyring credential for the current origin. Skills generation creates a new directory offline and does not overwrite an existing directory.
Usage: kitta batch validate [options] <manifest> Validate a versioned JSON batch manifest without network access Arguments: manifest Batch manifest JSON file Options: -h, --help display help for command Usage: kitta batch run [options] <manifest> Run a new recoverable batch Arguments: manifest Batch manifest JSON file Options: --concurrency <count> Override manifest concurrency (1-8) -h, --help display help for command Usage: kitta batch status [options] <run-id> Read a persisted batch run without network access Arguments: run-id Batch run UUID Options: -h, --help display help for command Usage: kitta batch resume [options] <run-id> Resume pending or failed tasks with their original idempotency keys Arguments: run-id Batch run UUID Options: --manifest <path> Manifest path when the original file moved --concurrency <count> Override saved concurrency (1-8) -h, --help display help for command Batch manifests use versioned JSON. Validate is offline, run returns a run ID, status reads redacted local state, and resume uses the original idempotency keys for incomplete items.