Twistly AI Presentation Maker

Submit an async job that generates a presentation from a PDF, PPTX, DOCX, or TXT document. The document arrives in exactly one of the following ways. file: an attachment reference the host fills in for a document the user attached. The server fetches the bytes from it directly, so the document never passes through the conversation and its size is not a limit. The object is valid only as the host produced it — there is no way to compose one from the conversation. file_url: an https URL the server downloads itself (with mime_type). file_base64: the encoded bytes (with mime_type), for small files. Returns a job_id; the result is read with get_job_status under that id.

create_from_file

Submit an async job that generates a presentation from a short topic prompt. Returns a job_id; the result is read with get_job_status under that id.

create_from_topic

Submit an async job that turns provided text into a presentation. Returns a job_id; the result is read with get_job_status under that id. Very long text is rejected by the backend token limit.

create_from_text

Return the current status of a generation job. A completed job carries result.url, a direct download link to the generated .pptx file. Generation runs for minutes: with wait=true the call holds open until the job settles or ~45 seconds pass, with wait=false it answers with the status at that moment. A job that is still processing when the call returns keeps running and stays readable under the same job_id.

get_job_status