answer_preview
ChatGPTRecord and finalize the user’s choices for an owned preview’s current round. Saved answers cannot be changed after the round closes. Use this after the user answers, sending only the option ids matching what the user actually chose. For select one send optionId; for select many send optionIds. Set finish only when the user explicitly wants Aisma’s choices for unanswered questions. A reading-check rejection cancels the preview so the user can change their request. Do not use without the user’s choices or an explicit request to finish with Aisma’s choices. This saves answers without spending credits.
get_account
ChatGPTYour Aisma credit balance and the limits and usage of this connection and account.
get_asset
ChatGPTChecks whether the Library video selected with use_library_video is ready for an edit quote.
get_job
ChatGPTStatus and progress of an edit. When resultReady is true, call get_result_link. Poll no more than every 10 seconds.
get_preview
ChatGPTRead an owned free preview and its questions. Use this after start_preview, polling no more than every few seconds. Present questions and options verbatim, including their time ranges. Keep this preview id across interruptions. When offerReady is true, explain offerCredits and ask for explicit confirmation before start_prepared_edit. Do not use for starting an edit, or treat a timeout or an answer as permission to start.
get_result_link
ChatGPTA private link to the finished video, valid for one hour.
import_chat_media
ChatGPTCopies a video and up to ten photos the user attached in this chat into their private Aisma account for an edit, and returns asset ids. Use this when the user attached a video (MP4 or MOV, 2–60 seconds, up to 500 MB) or JPEG, PNG or WebP photos and wants them in an edit; then call get_asset for each id until ready, and pass the video as sourceId and the photos labelled 1, 2, … in the returned order to quote_edit. If a copy fails because its link expired, call this again with the same files. Do not use for files not attached here, web links, making a new video from text, or a video already in the Aisma Library.
list_library
ChatGPTYour Aisma Library, newest first, with each edit's status.
quote_edit
ChatGPTSaves a 15-minute quote for an edit of a ready source video selected with use_library_video. It returns the credit cost without reserving credits. If pending, try again after retryAfterMs.
report_widget_error
ChatGPTRecord a fixed diagnostic for an unexpected Aisma card failure. Use this when the card encounters an unexpected render, action or media decoding failure. Do not use for normal refusals, validation, offline, authorization or timeouts. Never send messages, stacks, choices, account or task ids, file names, media links or other private data.
show_edit
ChatGPTShow Aisma examples, the owned preparation questions, or the progress and result of an existing edit inside this chat. Use this when the user wants examples (kind start), after start_preview returns a preview id (kind preview), or after an edit starts or the user asks to see its progress/result (kind job). Pass only the id from Aisma. The card reads fresh owner data itself; do not pass snapshots or URLs. This display never starts an edit or spends credits. Do not use for starting an edit, changing answers or selecting another user's task. The result contains card data and does not verify that the host displayed it. Do not announce a display failure from this result. Use text fallback only on an explicit host UI-unavailable signal or the user's report of a display problem.
start_edit
ChatGPTStarts the edit for a quote and reserves its credits from your Aisma balance. Confirm the price with the user first. Then poll get_job; the finished video lands privately in your Aisma Library.
start_prepared_edit
ChatGPTStart the owned preview’s prepared edit and reserve credits, keeping its exact answers and plan. Use this only after offerReady and the user explicitly confirms the returned credit amount. Pass that amount as acceptedCredits. If the amount changes, explain it and obtain a fresh confirmation. Retries return the same job. Do not use without that explicit confirmation. Poll get_job and use get_result_link when ready.
start_preview
ChatGPTPrepare a free preview of the selected ready video and instruction, using the account’s shared allowance of three previews. Use this when preparing a first edit, even when the account has enough credits. This studies the video and asks one to three useful questions in this chat without starting an edit or reserving credits. Poll get_preview, present its exact questions and option labels to the user, then send their choices with answer_preview. If pending, wait retryAfterMs and repeat with the same input. Do not use for starting a paid edit, or call quote_edit or start_edit while this preview is active. A preview_unavailable refusal permits the ordinary quote path.
use_library_video
ChatGPTUses one of your finished Aisma videos (a job id from list_library) as the source video of a new edit. Returns its asset id.