AI Inference

Buy a prepaid AI inference key. Paid; the quoted price is the charge. Inputs: `creditUsd`, any USD amount in whole cents between get-inference-pricing's `credit.minUsd` and `credit.maxUsd` (for example "5.50"), and `acceptTerms` equal to its `termsVersion`, confirming you accept those terms. Issues one OpenAI-compatible API key for NEAR AI Cloud with that USD credit as its spending limit. Calls are billed at NEAR's published per-model prices against that credit; when it runs out NEAR refuses further calls until you top up. A wallet may hold several keys, for example one per agent. Returns `keyId` and `inferenceOrigin`. Next: call `get-inference-key` to receive the secret, then call the models directly. Owner operations are wallet-authorized through the Daski gateway (daski_use_asset); the provider rejects anonymous access.

Add credit to one of your inference keys. Paid; owner only. Inputs: `keyId`, `creditUsd` (any amount in range, in whole cents) and `acceptTerms` (current `termsVersion`). The same secret keeps working with the added credit. If earlier calls overran the key's credit, part of the new credit covers that and `appliedToPriorDebtUsd` reports how much. Owner operations are wallet-authorized through the Daski gateway (daski_use_asset); the provider rejects anonymous access.

Read one of your inference keys: its status, credit bought, remaining balance (with its time and whether it is provisional), the secret's prefix, pending purchases, and the API key secret itself while it can still be delivered (`apiKeyAvailableUntil`, 7 days after issue by default). The secret is generated for this response only and never stored in an order or action record; store it securely, because anyone holding it can spend your credit. After the window, `apiKey` is null; rotate-inference-key issues a new secret. Free; owner only. Owner operations are wallet-authorized through the Daski gateway (daski_use_asset); the provider rejects anonymous access.

Read NEAR-reported usage for one of your keys: model, tokens and cost per call, newest first, paginated by `limit` (1-100) and `offset`. Shows calls made with the current secret (since the last rotation). NEAR reports usage with a short delay. No prompts or outputs are stored or returned. Free; owner only. Owner operations are wallet-authorized through the Daski gateway (daski_use_asset); the provider rejects anonymous access.

Stop a key's secret immediately, for example if it leaked. Credit and balance are kept; issue a new secret later with rotate-inference-key. Destructive; requires delayed wallet confirmation. Input `keyId` and `currentKeyPrefix` from get-inference-key. Owner operations are wallet-authorized through the Daski gateway (daski_use_asset); the provider rejects anonymous access.

Replace a key's secret: the current secret stops working and a new one is issued under the same `keyId` with the remaining balance. Destructive; requires delayed wallet confirmation. Input `keyId` and `currentKeyPrefix` from get-inference-key (after a revocation, the revoked secret's prefix). Then call get-inference-key for the new secret. Owner operations are wallet-authorized through the Daski gateway (daski_use_asset); the provider rejects anonymous access.

List how much AI inference credit you can buy and its USDC price, the current customer terms and the models you can call with their per-token prices. Free, no auth, creates nothing. Returns: `credit` (`minUsd`, `maxUsd`, `incrementUsd`: any amount in that range, in cents) and `priceUsdcPerCreditUsd` (the quote rounds up to the cent), `termsVersion` and `termsUrl`, the `inferenceOrigin` your key calls, `models` (NEAR's current catalog: `model`, input/output/cache-read USD per million tokens, `usdPerImage` for image models, `contextLength`, and `private`: true when the model runs in NEAR's confidential-computing hardware), `privacy`, and `purchasable: false` with a `reason` when sales are paused or funding is unavailable. Next step: buy `create-inference-account` with a `creditUsd` in range and `acceptTerms` set to `termsVersion`.