List the AI models available to your Deepy API key (only opened/available models are returned). Returns every matching model grouped by generation type; [refs] marks models that accept reference files. One call is enough — pass type/family/group only to narrow the catalogue, never to work around a truncated result. Use this before estimating or creating a generation.

Fetch the full schema for one model: its parameters, reference-file limits, generation type, and max prompt length. A closed or unknown model returns MODEL_NOT_FOUND (closed models are never revealed).

Rewrite a draft prompt into a stronger one for the given modality (image/video/audio). Returns the improved prompt text to use as the base in estimate/create — review it first, the rewriter can invent style references that do not exist.

Upload an image, video, or audio attachment (up to 50 MiB) to Deepy and return its fileId. For files attached directly to the agent window, pass their absolute local path as filePath. Call this before estimate/create and pass the returned id in referenceFiles.

Get the integer token cost and resulting balance for a generation, without charging anything. Always estimate and confirm with the user before creating. The exact same params must be passed to deepy_create_generation (quote == charge).

Start a PAID generation. Requires confirmed=true — the tool refuses otherwise and contacts no backend. Params must be byte-identical to the estimate (quote == charge). An X-Idempotency-Key is auto-generated to prevent double-charging.

Fetch a generation's current status, error info, and result indexes by publicId. Poll this after create until status is COMPLETED or FAILED.

Fetch a COMPLETED generation's result media. The server fetches the bytes with its own API key, saves the full-resolution file locally on the user's device and returns its path, and inlines small images/audio (base64) so they render in-chat. Videos and large media are streamed straight to the saved local file (never inlined as base64), so there is no practical size limit. Never exposes the API key or a raw URL.

Open the Deepy credits top-up page in the user's default browser and return its URL. Call this when a balance is too low to cover a generation (deepy_estimate_generation returned canAfford=false, or a create failed with INSUFFICIENT_CREDITS) and the user wants to add credits. Opens a page only — it never moves money or charges anything.