The opsfy CLI

For a tool shown in your private tools, run opsfy info <tool> --json first. OpenRouter text chat takes model, prompt, optional system and optional max_tokens. Model ids are listed at https://openrouter.ai/models. Use opsfy call openrouter --input model=<model> --input prompt="<text>" --input max_tokens=500 --json, or --input-file input.json for one UTF-8 JSON object; --input-file - reads standard input. OpenRouter prompt and system each allow 131,072 Unicode characters, including line breaks; the JSON file and encoded request allow 1,048,576 bytes. Other tools keep their existing limits. The input hold uses the model endpoints' published prompt limit, so even a short prompt may need a large hold. The output hold always uses the published maximum, even with max_tokens; the unused hold is released when the call ends. Every model is enabled, including free models at $0, when its published prices and limits pass these checks. The call waits for the complete answer up to 8,388,608 UTF-8 bytes; an interrupted or larger answer has no retained text and is settled from the generation record. The answer shows text, answering model, input and output tokens, held amount and charged amount. If the terminal closes, run opsfy jobs --json and check the job before calling again; the charge settles from the company's record. Opsfy does not retain the text, so a lost answer cannot be recovered. A company credit refusal means the tool is unavailable; adding to your Opsfy balance does not fix it.

Jev answers typed questions about text for authorized private-tool accounts. Use CLI 0.8.0: run opsfy info jev --json, then opsfy call jev --input-file input.json --json. input.json contains model (typesafe/jev-1.14 or typesafe/jev-1.13), state (text, up to 131,072 characters) and questions (a JSON object, up to 65,536 UTF-8 bytes and 16 container levels). A question has type noul, choice or score; choice criteria have 1 to 255 options and score criteria have 1 to 10 levels. The whole input file and request are limited to 1,048,576 UTF-8 bytes. Named --input questions accepts JSON text. Images, assets, box questions, aliases and other models are refused. The call reads current prices and holds the published context maximum; it charges actual use. A refusal or failure at the start costs nothing unless the company reports a usable charge; that figure decides, capped at the hold. An answer that never comes, or a complete Jev answer with no usable figure, pays the hold. Answers keep the returned numbers, model, input tokens, held amount and charged amount. A long call waits; after an interrupted answer, run the returned opsfy job status command before calling again. Opsfy does not retain the state, questions or answers. Other accounts see Jev as not open yet.

For a tool that returns audio, run opsfy info <tool> --json for its model ids, limits and available voice ids. Call ElevenLabs with opsfy call elevenlabs --input text="<text>" --input voice=<id> --out voice.mp3 --json, or --input-file input.json for text with line breaks. Optional model defaults to eleven_multilingual_v2. Only text, voice and model are accepted; the file is MP3 (mp3_44100_128). Use a new output path; an existing file is never overwritten. Audio streams directly into that file and never appears in terminal output. The answer reports file, bytes, counted_units, held_microusd and charged_microusd; counted_units is ElevenLabs' character-cost figure, not the text length. Amounts are exact millionths of a US dollar. The input file and encoded request allow 1,048,576 UTF-8 bytes; each model's character limit still applies. The call waits without a time limit. Settlement uses the count received with the audio headers, even if delivery is interrupted; without a usable count, it charges the hold. A company refusal or failure at the start costs nothing unless it supplies a usable count; then that count decides the charge. An unanswered start is charged its hold. If the terminal closes, run opsfy jobs --json before starting another call. A detected interruption removes the partial output file when possible; if removal fails, the answer names the remaining partial file and tells you to remove it. After a forced process kill, treat any file as incomplete until a successful answer confirms it. Opsfy retains no text or audio and cannot recover the clip. A company credit or key-limit refusal means ElevenLabs is unavailable; adding to the Opsfy balance does not fix it. Private tools are available only to their authorized accounts.

For a rental in your private tools, run opsfy info runpod --json first. Give gpu, image and disk; cloud defaults to SECURE and gpu_count to 1. Pass ports as 8000/http,22/tcp, and env as an object of strings in --input-file pod.json. Opsfy reserves 15 minutes ahead and renews while the balance covers another 15. Run opsfy job wait <id> --json for the address, opsfy job status <id> --json for the paid-until time and charges, and opsfy job stop <id> --json to delete the pod and its container disk. Waiting stops when the address is ready; ending the terminal does not stop the rental. The address is public: keep your own server key; stream long generations or add a TCP port because HTTP proxy connections end at 100 seconds. Opsfy does not relay your model requests. A start refused by Runpod costs nothing without a usable charge figure. An unanswered start pays its first hold; Opsfy searches for and deletes that pod. Run opsfy jobs --json and ask the person before starting another rental after an unconfirmed start. If checking stops, the pod can outlive its paid time; those unheld minutes are paid by Opsfy. Each settled 15-minute slice appears in opsfy logs --json. Runpod credit or account limits mean Runpod is unavailable; adding to the Opsfy balance does not fix them.

For a tool shown in your private tools, run opsfy info tavily-research --json first. Start a report with opsfy call tavily-research "<question>" --input model=mini --json; choose mini or pro. The question allows 1 to 2,000 characters. opsfy info tavily-research --json shows each model's hold and the price of a reported credit; the final charge never exceeds the hold. Optional citation_format takes numbered, mla, apa or chicago; optional output_length takes short, standard or long. Omit either to use Tavily's default. A start returns a job id: run opsfy job wait <id> --json, then opsfy job result <id> --json for text and source titles and URLs. A report may take minutes and cannot be stopped. Closing the terminal does not stop it; run opsfy jobs --json to recover its id. Failed jobs pay their reported use, including zero; missing usage, a report too large to read, an unconfirmed start or a deleted status record costs the hold. A refused start without reported use costs nothing. If a result is gone, its settled charge stands. Opsfy does not store the question or report. A company credit refusal means research is unavailable; adding money to Opsfy does not fix it. If research is not listed in your private tools, update the CLI and run opsfy info tavily-research --json again; it may not be open to your account.

For an authorized private Apify tool, run opsfy info apify --json, then opsfy call apify --input-file input.json --json. The file contains actor, max_usd as a positive dollar string such as "0.10", and an optional input object. Actor ids are written user/name; user~name is the same. Only Actors whose cost Apify caps and that need no full account access are available. The run holds its maximum from max_usd and charges actual use up to that hold, including failed, stopped and timed-out runs. An unanswered start or a deleted status record pays the hold. Follow the returned opsfy job command; waiting does not stop the run. Run opsfy job result <id> --json for up to 50 items from the first dataset page, within 262,144 UTF-8 bytes. Each result read has a separate hold and charge, shown in result_read; repeated reads are charged again. A missing result does not change the run charge. Opsfy stores neither input nor results. Apify retains them in its account; result availability is not guaranteed. Apify account limits mean the tool is unavailable right now; adding to the Opsfy balance does not fix them. Other accounts see Apify as not open yet.

For serverless jobs in your private tools, use CLI 0.8.0. Run opsfy info runpod-serverless --json for Opsfy endpoint names, models, GPU pools and hourly prices. Call opsfy call runpod-serverless --input-file input.json --json with the complete input object; do not combine named inputs and --input-file. The file contains endpoint, input (a JSON object, at most 65,536 UTF-8 bytes and 16 container levels), and optional seconds (5 to 604800; default 600). The whole file and request allow 1,048,576 UTF-8 bytes. A named --input input accepts JSON text. The hold covers the limit, up to 420 seconds of waiting and 5 seconds after running. The charge uses the reported run time, waiting capped at 420 seconds and 5 seconds after running; a job reported as never run costs zero. Waiting can include queue time. A refused start without usable usage costs zero; an unanswered start, a deleted status record or missing final usage pays the hold. Every charge is capped at the hold. Run the returned opsfy job wait <id> --json, or job status, stop or result. A stop keeps the hold until Runpod reports the end. Results are available while Runpod keeps them, normally 30 minutes; Opsfy stores neither input nor output. The result is an object containing output, preserving any JSON output type. An output above 262,144 UTF-8 bytes cannot be relayed, but its charge still settles. Missing or invalid output has a separate result error; the charge stands. Runpod credit or account limits mean Runpod is unavailable; adding to the Opsfy balance does not fix them. An unknown endpoint needs a name from opsfy info runpod-serverless --json; a sleeping endpoint needs the person to wake it. Other accounts see this tool as not open yet.