polymorfa voice
Voice Automation (beta): audio library and text-to-speech provider credentials.
polymorfa voice audio delete
Delete audio (beta).
Delete an audio asset permanently. Fails with voice_asset_in_use (exit code 4) while a campaign or flow uses it. Works after the Voice Automation beta is withdrawn. Requires a server API key with voice:manage.
Usage
polymorfa voice audio delete ASSET [flags]Arguments
ASSETrequiredAudio asset ID.
Flags
--yesbooleanConfirm permanent deletion without prompting.
Also accepts the global flags.
polymorfa voice audio list
List audio (beta).
List the project's audio library, newest first. Requires a server API key with voice:read. Voice Automation is a beta (calls.voice-automation) for enrolled teams only; other teams get voice_not_enabled (exit code 6).
Usage
polymorfa voice audio list [flags]Examples
polymorfa voice audio list --project 018f0000-0000-7000-8000-000000000002polymorfa voice audio list --status ready --limit 100 --project 018f0000-0000-7000-8000-000000000002Flags
--cursor <value>takes a valueContinue from this opaque cursor.
--limit <value>takes a valueReturn at most this many assets (1 to 100; API default 50).
--status <value>takes a valueOnly list assets with this status.
Allowed valuespending_uploaduploadedtranscodingreadyfailed
Also accepts the global flags.
polymorfa voice audio preview
Get a preview link for audio (beta).
Print a link to the transcoded audio (Opus in Ogg, 16 kHz mono). The link works for 5 minutes; treat it as a secret. --output downloads it instead of printing it. Fails with asset_not_ready (exit code 4) before the asset is ready. Requires a server API key with voice:read. Voice Automation is a beta (calls.voice-automation) for enrolled teams only; other teams get voice_not_enabled (exit code 6).
Usage
polymorfa voice audio preview ASSET [flags]Examples
polymorfa voice audio preview 6f1c2f0e-1d5b-4d8e-9a55-0d4b8a6c1f10polymorfa voice audio preview 6f1c2f0e-1d5b-4d8e-9a55-0d4b8a6c1f10 --output greeting.oggArguments
ASSETrequiredAudio asset ID.
Flags
--forcebooleanOverwrite an existing output file.
-o, --output <value>takes a valueDownload the preview to this file.
Also accepts the global flags.
polymorfa voice audio tts
Create audio from text to speech (beta).
Render text to speech into a new library asset. Without --credential, Polymorfa's managed key for the provider is used; with it, your stored provider credential for the same provider. Text is 1 to 5000 characters (4096 for openai). OpenAI voices: alloy, ash, ballad, coral, echo, fable, nova, onyx, sage, shimmer, verse. ElevenLabs takes a voice ID. Models: elevenlabs eleven_multilingual_v2 (default), eleven_flash_v2_5, eleven_turbo_v2_5; openai gpt-4o-mini-tts (default), tts-1, tts-1-hd. Requires a server API key with voice:manage. Voice Automation is a beta (calls.voice-automation) for enrolled teams only; other teams get voice_not_enabled (exit code 6).
Usage
polymorfa voice audio tts [flags]Examples
polymorfa voice audio tts --name "Welcome" --text "Thanks for calling." --provider openai --voice alloy --project 018f0000-0000-7000-8000-000000000002polymorfa voice audio tts --name "Menu" --text-file menu.txt --provider elevenlabs --voice 21m00Tcm4TlvDq8ikWAM --credential 6f1c2f0e-1d5b-4d8e-9a55-0d4b8a6c1f10 --wait --project 018f0000-0000-7000-8000-000000000002Flags
--credential <value>takes a valueUse this stored provider credential instead of the managed key.
--model <value>takes a valueProvider model; the provider's default when omitted.
--name <value>takes a valuerequiredName shown in the library (1 to 100 characters).
--provider <value>takes a valuerequiredText-to-speech provider.
Allowed valueselevenlabsopenai--retention-days <value>takes a valueDelete the audio this many days after creation (1 to 3650). Omit to keep it until deleted.
--text <value>takes a valueText to speak.
--text-file <value>takes a valueRead the text from a UTF-8 file, or stdin (-).
--voice <value>takes a valuerequiredOpenAI voice name or ElevenLabs voice ID.
--waitbooleanWait until the audio is ready or failed. A failed asset exits with code 13.
--wait-timeout <value>takes a valueStop waiting after this many seconds (exit code 5).
Default120
Also accepts the global flags.
polymorfa voice audio update
Change audio (beta).
Rename an audio asset or change how long it is kept. --expected-revision refuses the change with voice_asset_revision_conflict (exit code 4) if the asset changed. Requires a server API key with voice:manage. Voice Automation is a beta (calls.voice-automation) for enrolled teams only; other teams get voice_not_enabled (exit code 6).
Usage
polymorfa voice audio update ASSET [flags]Examples
polymorfa voice audio update 6f1c2f0e-1d5b-4d8e-9a55-0d4b8a6c1f10 --name "Greeting v2" --expected-revision 2polymorfa voice audio update 6f1c2f0e-1d5b-4d8e-9a55-0d4b8a6c1f10 --retention-days noneArguments
ASSETrequiredAudio asset ID.
Flags
--expected-revision <value>takes a valueRefuse the change if the asset no longer has this revision.
--name <value>takes a valueNew name (1 to 100 characters).
--retention-days <value>takes a valueDays to keep the audio after creation (1 to 3650), or none to keep it until deleted.
Also accepts the global flags.
polymorfa voice audio upload
Upload an audio file (beta).
Upload a recording to the project's audio library. The content type comes from the file extension; other types and files over 16 MB are refused before anything is sent. The asset is returned while it is transcoded to 16 kHz mono; pass --wait to wait until it is ready or failed. Requires a server API key with voice:manage. Voice Automation is a beta (calls.voice-automation) for enrolled teams only; other teams get voice_not_enabled (exit code 6).
Usage
polymorfa voice audio upload FILE [flags]Examples
polymorfa voice audio upload greeting.mp3 --name "Greeting" --project 018f0000-0000-7000-8000-000000000002polymorfa voice audio upload hold.wav --name "Hold music" --retention-days 30 --wait --project 018f0000-0000-7000-8000-000000000002Arguments
FILErequiredAudio file: .mp3, .wav, .ogg, .opus, .m4a or .mp4, at most 16 MB.
Flags
--name <value>takes a valuerequiredName shown in the library (1 to 100 characters).
--retention-days <value>takes a valueDelete the audio this many days after creation (1 to 3650). Omit to keep it until deleted.
--waitbooleanWait until the audio is ready or failed. A failed asset exits with code 13.
--wait-timeout <value>takes a valueStop waiting after this many seconds (exit code 5).
Default120
Also accepts the global flags.
polymorfa voice audio view
Show audio (beta).
Show one audio asset, including its status, failure reason and revision. Requires a server API key with voice:read. Voice Automation is a beta (calls.voice-automation) for enrolled teams only; other teams get voice_not_enabled (exit code 6).
Usage
polymorfa voice audio view ASSET [flags]Arguments
ASSETrequiredAudio asset ID.
Flags
Also accepts the global flags.
polymorfa voice credential add
Store a provider key (beta).
Store your own ElevenLabs or OpenAI key for text to speech. The key is read from the environment variable named by --key-env (default POLYMORFA_VOICE_PROVIDER_KEY) or, when that is unset, from standard input; never from an argument. The provider checks the key first; a rejected key fails with provider_credential_invalid (exit code 2). Only the key's fingerprint is ever shown. With --project the credential belongs to that project; without it, every project of the team can use it. Requires a server API key with voice:manage. Voice Automation is a beta (calls.voice-automation) for enrolled teams only; other teams get voice_not_enabled (exit code 6).
Usage
polymorfa voice credential add [flags]Examples
printf '%s' "$ELEVENLABS_API_KEY" | polymorfa voice credential add --provider elevenlabs --label "Studio key"POLYMORFA_VOICE_PROVIDER_KEY="$OPENAI_API_KEY" polymorfa voice credential add --provider openai --label "Support line" --project 018f0000-0000-7000-8000-000000000002polymorfa voice credential add --provider openai --label "CI" --key-env OPENAI_API_KEYFlags
--key-env <value>takes a valueRead the key from this environment variable (default POLYMORFA_VOICE_PROVIDER_KEY; standard input when that is unset).
--label <value>takes a valuerequiredLabel shown in lists (1 to 100 characters).
--provider <value>takes a valuerequiredProvider the key belongs to.
Allowed valueselevenlabsopenai
Also accepts the global flags.
polymorfa voice credential delete
Delete a provider credential (beta).
Delete a stored provider key. Text to speech that names it then fails; audio already created is kept. Works after the Voice Automation beta is withdrawn. Requires a server API key with voice:manage.
Usage
polymorfa voice credential delete CREDENTIAL [flags]Arguments
CREDENTIALrequiredProvider credential ID.
Flags
--yesbooleanConfirm permanent deletion without prompting.
Also accepts the global flags.
polymorfa voice credential list
List provider credentials (beta).
List the team-wide provider credentials and, with --project, that project's own. Keys are never returned; each credential shows its fingerprint and status. Requires a server API key with voice:read. Voice Automation is a beta (calls.voice-automation) for enrolled teams only; other teams get voice_not_enabled (exit code 6).
Usage
polymorfa voice credential list [flags]Examples
polymorfa voice credential listpolymorfa voice credential list --project 018f0000-0000-7000-8000-000000000002Flags
Also accepts the global flags.
polymorfa voice credential verify
Check a provider credential again (beta).
Check the stored key with the provider again and show the updated status. A rejected key fails with provider_credential_invalid (exit code 2); an unreachable provider with provider_unavailable (exit code 5). Requires a server API key with voice:manage. Voice Automation is a beta (calls.voice-automation) for enrolled teams only; other teams get voice_not_enabled (exit code 6).
Usage
polymorfa voice credential verify CREDENTIAL [flags]Arguments
CREDENTIALrequiredProvider credential ID.
Flags
Also accepts the global flags.
polymorfa voice credential view
Show a provider credential (beta).
Show one provider credential: its provider, label, key fingerprint, status and last error. The key is never returned. Requires a server API key with voice:read. Voice Automation is a beta (calls.voice-automation) for enrolled teams only; other teams get voice_not_enabled (exit code 6).
Usage
polymorfa voice credential view CREDENTIAL [flags]Arguments
CREDENTIALrequiredProvider credential ID.
Flags
Also accepts the global flags.