get_video

pro.aicut/aicut · Verify this server

Returns the current state of one video generation on the signed-in account. This is a SINGLE, IMMEDIATE read - it does not wait for anything. WHEN: only when you need one job's raw fields right now - what it cost, whether it was refunded, why it failed. It is NOT how you wait for a generation and it is NOT how you show one to the user. TO WAIT for a running video, call `wait_for_generation` instead: it waits server-side for up to 15 seconds per call, so it costs a fraction of the calls that polling this tool in a loop would. You do NOT need this to show a video: `generate_video` already put the aicut card up, and `show_generation` brings back an earlier one. Do not poll this tool repeatedly. TIMING: a video usually finishes in 1-3 minutes, and can take up to about 6. Do not assume it failed before then, and do not spawn timers or background shells to wait: call `wait_for_generation` (it waits server-side for up to 15 seconds per call), wait its `poll_after_seconds` and call it again, and stop when it answers `terminal: true`. `get_video` is a single immediate read for one job's raw fields - it is not the waiting loop and must not be polled in one. `status` is one of `queued` (accepted, not started), `processing` (running), `succeeded` (the `url` field is a public link to the finished file), or `failed` (terminal - `error.message` says why, and nothing further will arrive). STORY EPISODES: an AI Video Story job additionally carries `story.stage`. `frames_review` means the run is WAITING FOR THE USER (show the frames, do not keep polling); `writing_failed` is TERMINAL with `status: "failed"` - the episode writer failed before anything generated, nothing was charged for it and the cast is saved, so offer a retry via a fresh `generate_story_video` with the same `cast_member_ids`. Once an episode has been rendered it also carries `story.render`, the verdict of the LATEST render: `stage: "rendered"` with `story.render.status: "succeeded"` is the finished episode and `story.render.url` is the FINAL file, while `story.render.status: "failed"` means that render failed and was refunded (the episode returns to `ready_to_render` and can be rendered again). At `ready_to_render` the episode url is only the raw stitched scene preview - do not hand it to the user as the final video. FAILURE HONESTY: when the user says something failed or looks wrong, NEVER argue from memory - read the job with this tool and report its actual state, what was charged and what was not, and the retry. Every failure line names the charges. The `url` is public and needs no credentials, so it can be given to the user directly. OUTPUT: this returns JSON for you to read. When you report back to the user, give them the media URL plus a one-line summary. Do not paste the raw JSON, job ids, or internal field names into the conversation.