Aitho

Adds grounding documents (PDF, Word, TXT, MD or CSV) by URL to an existing talk's private Q&A; their text is extracted and used to answer audience questions. Each document is reported individually: ones that fail are listed with a reason and the rest are still added.

aitho_add_documents

For practising the questions that follow a talk, pitch or defense, with answers drawn from the presenter's own slides and documents. Sends a question to the active deck's private Q&A and returns the answer. Answers come from the deck's material and attached Q&A documents; when those do not cover the question, a live web lookup may run, which counts against the account's monthly web-lookup limit. Requires an active presentation.

ask

For speaker notes, a talk track or a teleprompter script for a talk, including shortening, retiming or rewriting a script so it sounds natural spoken aloud. Attaches or replaces the speaker script on an existing talk. The script is a JSON array of strings, one per slide in slide order: entry i is spoken on slide i+1, and an empty string means no script for that slide. There are no in-text slide markers. If the array length differs from the talk's slide count, the call is rejected with a specific mismatch error (for example 'script has 12 entries, deck has 9 slides'); aitho_get_talk returns the slide count and per-slide text. Optional clips[slide].narrate_over sets per video whether the presenter talks over it (true: tracking continues) or the video does the talking (false: the teleprompter pauses).

aitho_attach_script

Returns the processing progress of a talk created with aitho_create_talk: stage (queued, converting, 'rendering n/N', attaching_script, ready or failed), slides_ready/slides_total, script_status, overall status (processing, ready, partial or failed), per-stage detail, and on failure an error_code (conversion_failed, corrupt_file, render_failed, script_slide_mismatch, timed_out, ...) with a specific reason. A typical 20-slide deck is ready in under a minute.

aitho_get_ingest_status

For rehearsing or delivering a presentation, pitch, talk, keynote, lecture, webinar, demo or thesis defense from the presenter's own slides, including a deck made earlier in the conversation. Creates a talk the presenter can rehearse out loud and present, from a PDF, PPTX or PPT deck, optionally with a per-slide speaker script and grounding documents for the private Q&A. The deck comes from exactly one of: deck_upload_id (a file uploaded through aitho_prepare_upload; its bytes go straight to Aitho and never pass through the conversation; no hosting required), deck_file (the file inline as base64, capped at 256,000 characters, about 190 KB), or deck_url (a deck already on the web, including gamma.app links, which are exported to PDF server-side). Returns a talk_id and status immediately; deck parsing and document extraction run asynchronously and are reported by aitho_get_ingest_status. clips[slide].narrate_over sets whether the presenter speaks over a video on that slide (true: the teleprompter keeps tracking) or the video carries the narration (false, the default: the teleprompter pauses).

aitho_create_talk

Returns a deck's metadata and a per-slide summary: which slides have a script, the number of Q&A documents, and a short script preview. Slide images are not included.

get_deck

Returns the live state of the active presentation: current slide (1-indexed) and phase ('present' or 'qa').

get_state

Returns the cue map that links each script segment to its slide (segment i drives slide i).

get_alignment

Returns the deck's per-slide speaker script (the teleprompter text); entry i is the script for slide i. Optional fromSlide/toSlide (1-indexed, inclusive) limit the range.

get_script

For reading the real text of every slide in a talk, as the basis for writing or reviewing a speaker script or building practice questions. Returns one talk in full, including the extracted text of every slide: per-slide {slide, text, hasScript, script}, the title, the slide count and the names of attached Q&A documents.

aitho_get_talk