get_audio

pro.aicut/aicut · Verify this server

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 polling this tool in a loop would. You do NOT need this to show a clip: `generate_audio` already put the aicut card up, and `show_generation` brings back an earlier one. Do not poll this tool repeatedly. TIMING: audio usually finishes in under a minute - often within 10 seconds for a short sound effect - and can take up to about 4 minutes for a long script. 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_audio` 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 audio file), or `failed` (terminal - `error.message` says why, and nothing further will arrive). 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.