Dayfaro

Create a podcast from source text. Set request.online_search=true (optional beta, off by default) to research a topic or read supplied public URLs first; planning, retrieval and generation consume credits. Sources are returned in research.sources and shown in the player. Does not schedule or monitor. Returns the accepted podcast with its latest job; immediately call podcast_player with the returned id to display live progress and playback. Set generate_audio=false to create only an editable script. Supply a stable idempotency_key when retrying identical inputs. Invalid settings, insufficient credits, or conflicting retry keys return an error without accepting duplicate work.

podcast_generate

Permanently delete an owned podcast, its script, and its library entry, and enqueue cleanup of its recordings. Use only when the user explicitly asks to delete that episode; this cannot be undone. Returns deleted=true after removal and spends no generation credits. Active jobs must finish first; unknown or already deleted IDs return not found.

podcast_delete

Record an owned podcast's saved or reviewed script using selected voices. Use after reviewing a draft or editing a script; no script-generation or research call is made. Speech generation consumes credits and replaces the recording when successful. Returns the podcast with its latest job; immediately call podcast_player with its id for progress and playback. Supply idempotency_key to retry identical inputs safely. Missing scripts, active jobs, invalid settings, insufficient credits, and unowned IDs return errors.

podcast_generate_audio

Read an owned podcast's saved settings, editable script, latest job, research sources, and expiring media download links. Use before editing a script or to refresh expired links; use podcast_player for listening and automatic progress. Does not generate or spend credits. Unknown or unowned IDs return a not-found error.

podcast_get

Discover supported languages, voice names, editorial styles, and request limits before creating or recording a podcast. Returns allowed choices and research availability; read-only and does not spend credits.

podcast_options

Read the connected Dayfaro account's ID, email, and prepaid credit balance. Use to confirm which account is connected; use account_credits when only the balance is needed. Returns the account identity and wallet snapshot, makes no purchases, and spends no generation credits. Requires an authenticated connection.

account_info

Check the connected account's prepaid wallet before generating a script or recording audio. Returns the customer-facing balance_credits, compatibility billing fields, and unlimited status. A zero remaining balance blocks paid generation unless unlimited is true. Read-only: does not purchase, top up, or spend credits. Requires an authenticated connection.

account_credits

Browse the connected account's podcast library, newest first, to find an episode ID before opening, editing, recording, or deleting it. Returns a page of podcasts plus total, page, and limit; an empty items list means no results on that page. Read-only and does not spend credits.

podcast_list

Show an owned podcast in an interactive player with generation progress, audio playback, transcript, and research sources. Call immediately after podcast_generate or podcast_generate_audio, even while queued, or when the user wants to listen to an existing episode. Returns a public status summary; signed media and transcript data stay in component-only metadata. Read-only: never generates audio or spends credits. The widget refreshes itself; no chat polling is needed. Unknown or unowned IDs return a not-found error.

podcast_player

Refresh the interactive player's status and expiring media links for an owned podcast. Intended for the app's automatic updates, not repeated chat polling; use podcast_player to open an episode. Returns a public progress summary and component-only playback metadata. Read-only; never creates a job or spends credits. Unknown or unowned IDs return a not-found error.

podcast_player_status