AICUT - AI Video Generator for Faceless Channels

Showing 25 of 50 from the live probe.

• Get aicut token balance

  Returns the signed-in aicut account's token balance and plan tier. WHEN: before starting an expensive generation, when the user asks what they have left, or after a generation fails for lack of tokens. Tokens are aicut's generation currency: every video, image and audio generation costs some. `list_models` publishes the price of each video and image settings combination; audio is priced on a rate, so quote it with `estimate_only: true` on `generate_audio` instead. OUTPUT: this returns JSON for y

• List aicut models

  Returns the AI video, image and audio models this API can generate with, each with the exact parameters it accepts (names, allowed values, limits, defaults where it has them), the media inputs it takes, and its pricing. WHEN: always call this before the first `generate_video`, `generate_image` or `generate_audio` of a session. Model names cannot be guessed, and neither can which resolutions, durations or aspect ratios a given model allows - `generate_*` rejects a combination this endpoint does n

• Generate an AI video

  Starts an AI video generation on the signed-in aicut account, puts the aicut card in front of the user, and returns the new job's id immediately. It does NOT wait for the video. WHEN: the user asks for a video to be made. Call `list_models` first if you have not this session - the `model` id and the allowed values for every other argument come from there, and a combination it does not publish is rejected. AFTER: the video is not ready when this returns, and waiting for it is not something you do

• Get an AI video job

  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 poll

• Delete one of the account's videos

  Deletes ONE video from the signed-in account's library. Any of the account's own videos, in any state - finished, failed, or still generating - exactly like the delete button in the aicut web app. WHEN: the user asks to remove a video, or to tidy up after a failed one. A story episode whose writer failed (`story.stage: "writing_failed"`) is the common case: it charged nothing and can simply be left, but this is how it goes away. NO REFUND, and say so before you delete anything the user might exp

• List the account's AI videos

  Returns the signed-in account's videos, newest first, one page at a time. WHEN: the user asks what they have made, or you need to find a video from an earlier session. This is the account's whole video library, so it includes videos made in the aicut web app and with products this API cannot yet create - not only ones generated through these tools. THIS IS HOW YOU FIND A STORY EPISODE, and every story tool needs its id. A row that is an AI Video Story episode carries `kind: "story_episode"` and

• Upscale an image

  Increases an existing image's resolution and returns the new job's id immediately. It does NOT wait for the result, and it does not change what the picture shows: same image, more pixels. WHEN: the user asks to upscale, enhance, sharpen, or increase the resolution of a picture they already have - including one an earlier `generate_image` call returned. It is NOT how you change what is IN the picture; that is `generate_image` with the picture as a reference. WHICH MODEL: `topaz-upscale-image` is

• Upscale a video

  Increases an existing video's resolution - 2x, 3x or 4x - and returns the new job's id immediately. It does NOT wait for the result, and it does not change the video's content: same shot, more pixels. WHEN: the user asks to upscale, enhance, sharpen or increase the resolution of a video they already have. It is NOT how you make a video look different - that is a new generation. THE CARD: this call has ALREADY put the aicut card in front of the user. It shows the prompt and the model straight awa

• Continue a video past its ending

  Generates a NEW segment that continues an existing video from its final frame, and returns the new job's id immediately. The result is the original clip with the new segment joined onto the end. WHEN: the user asks to extend, continue or lengthen a video, or wants to see what happens next in a clip they already have. Call `list_models` first if you have not this session: `model` and the allowed `aspect_ratio`, `resolution` and `duration` values come from there, and this tool accepts only models

• Make a character copy a video's motion

  Takes a picture of a character and a reference video, and generates a video of THAT character performing the motion in the reference clip - a dance, a walk, a gesture. Returns the new job's id immediately. WHEN: the user wants their character to dance, to copy a move, or to perform the motion from a clip they have. The reference clip supplies the MOVEMENT only; the character comes entirely from the picture. The reference clip must be between 3 and 30 seconds (10 if the character picture is a sti

• Make a picture of a person speak your audio

  Takes a picture of a person and an audio file, and generates a video of THAT person speaking or singing the audio, lip-synced. Returns the new job's id immediately. The result is exactly as long as the audio. WHEN: the user wants a talking avatar, a presenter, a voiceover put on a face, or a portrait to say something. The picture supplies the person; the audio supplies both the performance AND the length. The audio must be a `generate_audio` result on this account - pass the id that tool returne

• Open a file picker in the conversation

  OPENS A FILE PICKER RIGHT HERE, in this conversation. The user presses a button, chooses a video OR A PHOTO from their own computer, and watches it upload - then it is on their aicut account and every tool can use it. There is no link, no page to open, and nothing for you to paste. CALL IT IMMEDIATELY, WITHOUT ASKING ANYTHING FIRST, the moment the user refers to a video OR IMAGE file on their machine - 'upscale the clip in my Downloads', 'extend the video I just recorded', 'make my character mov

• Upload a file from this machine

  Puts a VIDEO OR IMAGE FILE FROM THE USER'S OWN MACHINE onto their aicut account, so the generation tools can use it. Returns an upload target in two forms - a ready-to-run curl command for you, and a `browser_upload_url` for the user - then you call `confirm_upload`. IF THE USER IS LOOKING AT A RENDERED CARD, YOU ARE ON THE WRONG TOOL. In claude.ai, Claude Desktop or the mobile apps, call `upload_media_widget` instead and stop - it opens a file picker inside the conversation, the person presses

• Finish an upload started by upload_media

  Checks the file that was uploaded to an `upload_media` target and makes it usable. Returns the media `url` to pass to other tools, the file's size, its `kind` (`video` or `image`), its measured `width` and `height`, and - for a video only - its `duration_seconds`. WHEN: immediately after the bytes moved - either the curl command from `upload_media` printed a 2xx status, or the user says they finished on the `browser_upload_url` page. There is no other time to call it. WHAT IT CHECKS, and why a f

• Generate an AI image

  Generates an AI image on the signed-in aicut account and puts the aicut card in front of the user. It waits for the image server-side for as long as one request safely can - about 20 seconds - so it usually returns the finished image with its `url` directly. WHEN: the user asks for an image. Call `list_models` first if you have not this session - the `model` id and the allowed values for every other argument come from there, and a combination it does not publish is rejected. AFTER: check `status

• Get an AI image job

  Returns the current state of one image 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 image, 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 poll

• List the account's AI images

  Returns the signed-in account's images, newest first, one page at a time. WHEN: the user asks what they have made, or you need to find an image from an earlier session - for example to pass its `url` back into `generate_video` as a start frame. This is the account's whole image library, so it includes images made in the aicut web app, not only ones generated through these tools. Paging: pass `cursor` from the previous response's `next_cursor` while `has_more` is true. `status` is one of `queued`

• Generate AI audio

  Starts an audio generation on the signed-in aicut account, puts the aicut card in front of the user, and returns the new job's id immediately. It does NOT wait for the audio. WHAT: one tool for all three kinds of audio - spoken voice-over, music, and sound effects - chosen by the `model` you pass, not by a different tool. WHEN: the user asks for speech, a voice-over, music, a soundtrack, or a sound effect. Call `list_models` with `type: "audio"` first if you have not this session: the models tak

• Get an AI audio job

  Returns the current state of one audio 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 running audio, 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 pollin

• List the account's AI audio

  Returns the signed-in account's audio generations, newest first, one page at a time. WHEN: the user asks what they have made, or you need to find a voice-over, track or sound effect from an earlier session. This is the account's top-level audio, so it includes audio made in the aicut web app, not only what these tools generated. It deliberately excludes the clips other products generate INSIDE a job - the per-line voice-overs and effects behind a story or a fake-text video - which are the larger

• List the voices this account can speak with

  The WHOLE voice catalogue - every voice aicut can speak with, across all three TTS providers: ElevenLabs (the platform's stock voices AND this account's own cloned and custom ones), OpenAI, and Amazon Polly. Free, instant, creates nothing. THIS IS WHERE EVERY VOICE ID COMES FROM. `generate_audio`'s `voice`, `generate_fake_text_video`'s `voice_left` / `voice_right`, and `generate_image_story`'s `voice` all want an id from this list. Do not invent one, and do not assume `list_models` publishes the

• Wait for a generation to finish

  Waits for one aicut generation to reach a terminal state, WITHOUT opening a widget or a card. It waits SERVER-SIDE for up to 15 seconds and returns the job's compact status. `terminal` is always present: `true` means the job is `succeeded` or `failed` and nothing further will arrive; `false` means it is still `queued` or `processing`. WHEN: immediately after `generate_video`, `generate_image` or `generate_audio`, and again every time it answers `terminal: false`. WHILE `terminal` IS FALSE: wait

• Show an earlier generation again

  Shows an EARLIER aicut generation to the user again, in the aicut card: the video, image or audio itself, with what it cost and when it was made. WHEN: the user asks to see something they already have - a generation from earlier in this conversation, or one found with `list_videos` / `list_images` / `list_audio`. That is this tool's only job. NOT PART OF MAKING SOMETHING NEW. `generate_video`, `generate_image` and `generate_audio` each put the aicut card up themselves, on the call that starts th

• Analyse a video

  Starts an AI analysis of an existing video on the signed-in aicut account and returns the new analysis's id immediately. It does NOT wait for the result. WHAT: reads the video and describes it in detail - what happens, who is in it, the on-screen text, the pacing and the cuts - as free-form text, plus the platform's own metadata (title, author, view count) when it has any. WHEN: the user wants to understand, break down, transcribe or copy the structure of a video they link to, or one they upload

• Get a video analysis

  Returns the current state of one video analysis on the signed-in account, and its result once it is finished. WHEN: after `analyze_video`, to find out whether the analysis is ready. Poll every 5-10 seconds until `status` is `succeeded` or `failed`. TIMING: an analysis usually finishes in under a minute, and can take a few minutes for a long window or a slow platform. Poll `get_analysis`; do not assume it failed before then, and do not spawn timers or background shells to wait - just poll on the