Auto Audio
Parameter reference
Every parameter the Auto Audio endpoints accept.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
url |
string | Yes | - | Article URL to convert |
publication_id |
string | Yes | - | Your publication ID |
eut |
string | No | auto | Analytics tracking token |
primary_voice_id |
string | No | pub setting | Primary narrator voice ID |
guest_voice_id |
string | No | pub setting | Secondary narrator voice ID |
conversation_mode |
boolean | No | false | Enable multi-voice mode |
read_urls |
boolean | No | false | Read URLs aloud |
read_alt_text |
boolean | No | false | Read image alt text |
sonic_optimizer |
boolean | No | false | Enable Audio Polish |
optimizer_level |
string | No | "2" | "0", "1", "2", "3" — anything else uses a conservative built-in prompt |
mix |
boolean | No | true | Run Creator’s mixer for this article. false = no intro/outro music. The delivered audio is always a finished master |
intro_mixable_id |
string | No | null | Custom intro audio ID. "shuffle" = a random intro, "" = no intro music, null = publication default |
skip_intro_mixable |
boolean | No | pub setting | Play no intro music (explicit form of intro_mixable_id: "") |
shuffle_intro_mixable |
boolean | No | pub setting | Play a random intro (explicit form of intro_mixable_id: "shuffle") |
outro_mixable_id |
string | No | null | Custom outro audio ID. "shuffle" = a random outro, "" = no outro music, null = publication default |
skip_outro_mixable |
boolean | No | pub setting | Play no outro music (explicit form of outro_mixable_id: "") |
shuffle_outro_mixable |
boolean | No | pub setting | Play a random outro (explicit form of outro_mixable_id: "shuffle") |
intro_duration |
integer | No | 0 | Intro length (seconds) |
outro_duration |
integer | No | 0 | Outro length (seconds) |
intro_pad |
integer | No | 0 | Intro padding (seconds) |
outro_pad |
integer | No | 0 | Outro padding (seconds) |
disclaimer |
string | No | null | Disclaimer text. "" silences it (same as suppress_ai_disclaimer: true), null = publication default; never send the literal string "false" — it would be narrated aloud |
disclaimer_voice_id |
string | No | null | Disclaimer voice ID |
suppress_ai_disclaimer |
boolean | No | false | Silence the spoken AI disclaimer for this article, overriding the publication's configured disclaimer |
read_author_in_audio_enabled |
boolean | No | true | Read author byline aloud |
language |
string | No | null | Language tag (en-US, es-MX, es) — skips detection for voice, disclaimer and TTS |
disable_language_detection |
boolean | No | false | Legacy alias for language: <publication default language> |
click_to_create |
boolean | No | false | From click widget |
content_last_published_timestamp |
integer | No | null | Unix timestamp (ms) |
dom_content |
string | No | null | Raw page HTML for content extraction |
rendered_html |
string | No | null | Rendered HTML for media extraction |
page_url |
string | No | null | Page URL for syndicated content |
client_version |
string | No | null | Calling client version. The widget sends "3.0.0" in the POST body and
inside evp. |