get_audio_devotional

io.github.alansafahi/soapbox-faith · Verify this server

The same daily devotional, SPOKEN — for members who would rather listen, or who read little. Returns audio URLs alongside the text. Requires an API key (speech costs money per character). Language: pass a consent_token with the 'context:read' scope and the member's own preferred language is used, so you need not ask them; or pass `language` explicitly for a one-off. If SoapBox has no voice for that language the tool says so and returns text only — it will NOT read the devotional in the wrong voice. SCRIPTURE IS ALWAYS SPOKEN IN ENGLISH (KJV) and its `translatable` flag is false. SoapBox never machine-translates Scripture and this API serves the public-domain KJV only. Never translate the verse yourself and never pass a translated verse back in. For a non-English member this is a TWO-STEP call: step 1 returns `translate_this` (our framing prose only — the opening, the reflection questions and the prayer prompt); translate just that into their language and call again with the same date and reference plus `reflection_text`, and you get both audio files back. For an English member one call returns the whole thing.