Cyber AI

The connected Cyber AI account: its number, the balance by currency (available is what can be spent right now, balance minus money reserved for running generations), and spending through connected apps: whether paid generations are allowed for this app, the per-generation and daily limits (null means no limit), spent today and remaining today. limits_url changes the limits.

cyberai_account

Cancel a generation started by this app while it is still waiting in the queue; the reserved money returns to the balance. A generation that has already started cannot be cancelled.

cyberai_cancel_generation

One generation of the connected account by generation_id (from cyberai_generate or cyberai_list_generations): status, stage, settings, money, and for a finished one its result texts and files with download urls that work while the files are stored (files_expire_at). cancellable tells whether cyberai_cancel_generation can still stop it; poll again after poll_after_seconds while it is queued or running. A failed generation has error (a short text for the person, show it as is) and error_code: provider_error means the model did not complete the request (read the reason: a temporary failure is worth one more try later, a refusal of the content needs other settings); refused means the request or the files need changes (error says what); failed means another failure described in error; timeout, internal, aborted, outage and not_saved mean the same request can simply be run again. A generation that failed before it started may have error_code only: price_changed (get a new quote), sg_unavailable, sg_maintenance and sg_model_disabled (try again later); any other code means the request was not accepted as it is. A failed generation is not charged. When the status is succeeded, call cyberai_show_result to show the files to the person.

cyberai_get_generation

Settings schema and documentation of one model: modes, fields with allowed values and limits, requirements for input files, examples. Use it to explain what the model can do and which settings it takes.

cyberai_get_model

Check the settings of a generation and get its price without spending anything. Returns quote_id (valid five minutes), the price, the settings exactly as they will be used, the available balance, the limits, and blocked_by when something would stop the launch now (paid_disabled, task_limit_exceeded, daily_limit_exceeded, insufficient_funds). Show the price to the person before cyberai_generate. Fields with files take https links to the files: for a file attached in the chat, upload it with cyberai_add_file and pass its file_url; to use a file of an earlier generation (for example to animate a picture that was just made), pass its url from cyberai_get_generation.

cyberai_estimate_cost

Generations of the connected account made through the API and connected apps, newest first: model, status, stage, money reserved, charged and refunded, error text. Page with next_cursor passed as before. Files are opened in the account (cabinet_url).

cyberai_list_generations

List the AI models of Cyber AI: model key, title, result type (image, video, audio or 3d) and whether the model is available right now. Use the key with cyberai_get_model.

cyberai_list_models

Show the files of a finished generation to the person: in chats that show app windows (ChatGPT, Claude) a window with the images, video and audio players and download buttons. Call it once, when cyberai_get_generation returns succeeded. Returns the same data as cyberai_get_generation with fresh file urls. Do not paste the files into your reply as Markdown images: the window shows them; give plain urls only if the person asks for them or no window is shown.

cyberai_show_result

Start the generation priced by cyberai_estimate_cost and charge the account balance. Call it only after the person agreed to the price, and pass that price as max_cost_minor. The same quote_id always gives the same generation, so a retry never charges twice. Money is taken only when the result is saved; a failed generation is not charged. Returns generation_id and the status; then poll cyberai_get_generation.

cyberai_generate

Get a one-time link to upload a file the person attached in the chat (an image, audio or video), so a generation can use it: generation settings take files only as https links, and an attached file has none. Pass the file name with its extension. Then upload the file yourself from your code execution sandbox with the returned command, putting the path of the attached file in place of <file>. In Claude attachments are under /mnt/user-data/uploads or /root/.claude/uploads (look with ls if unsure); in Claude Code or Codex use the path of the file on the computer, and in Windows PowerShell run curl.exe instead of curl (there curl is another command). The command prints the answer and then HTTP with the status: 201 carries file_url, pass it in the settings field for the file; 5xx is a temporary failure, run the same command again in a minute. The link takes one file and works for 24 hours; for another file, or after that, call this tool again. If the network blocks the upload (for example 403, host_not_allowed or CONNECT tunnel failed), the person has to allow our domain once: in Claude go to Settings, Capabilities, add allow_domain to Additional allowed domains (or choose All domains), then ask you to try again in this chat; only if it is still blocked after that, start a new chat. Tell the person exactly that and do not send the file anywhere else.

cyberai_add_file