@blockrun/llm 3.14.0 → 3.14.2

package/dist/index.d.cts

@@ -618,7 +618,7 @@ interface SpeechClientOptions extends ApiKeyOptions {
     /** Request timeout in milliseconds (default: 120000 — synthesis is synchronous) */
     timeout?: number;
 }
-/** TTS model IDs (price per 1k chars: flash/turbo $0.05, multilingual-v2/v3 $0.10). */
+/** TTS model IDs. Billed per 1k characters; rates at https://blockrun.ai/models. */
 type SpeechModel = "elevenlabs/flash-v2.5" | "elevenlabs/turbo-v2.5" | "elevenlabs/multilingual-v2" | "elevenlabs/v3";
 /** Friendly voice aliases (raw ElevenLabs voice_ids also accepted). */
 type SpeechVoice = "sarah" | "george" | "laura" | "charlie" | "river" | "roger" | "callum" | "harry" | (string & {});
@@ -805,7 +805,7 @@ interface VideoGenerateOptions {
     /**
      * Virtual Portrait asset ID (`ta_xxxxxx`) — keeps the same AI character
      * across multiple Seedance videos. Enroll via `POST /v1/portrait/enroll`
-     * ($0.01 USDC promo, no KYC). **Seedance 2.0 fast/pro only.** Mutually exclusive
+     * (promotional rate, no KYC). **Seedance 2.0 fast/pro only.** Mutually exclusive
      * with `imageUrl`. Real-person likeness is not supported on BlockRun.
      */
     realFaceAssetId?: string;
@@ -1392,7 +1392,7 @@ declare class LLMClient {
     exa(path: string, body: Record<string, unknown>): Promise<Record<string, unknown>>;
     /**
      * Neural web search via Exa. Returns semantically relevant URLs and metadata.
-     * Understands meaning, not just keywords. $0.01/call.
+     * Understands meaning, not just keywords.
      *
      * @param query - Natural language search query
      * @param options - Optional filters (numResults, category, date range, domains)
@@ -1400,20 +1400,20 @@ declare class LLMClient {
     exaSearch(query: string, options?: ExaSearchOptions): Promise<ExaSearchResponse>;
     /**
      * Ask a question and get a cited, synthesized answer grounded in real web sources.
-     * No hallucinations — every claim is backed by a citation. $0.01/call.
+     * No hallucinations — every claim is backed by a citation.
      *
      * @param query - The question to answer
      */
     exaAnswer(query: string): Promise<ExaAnswerResponse>;
     /**
-     * Fetch full Markdown text content from a list of URLs. $0.002 per URL.
+     * Fetch full Markdown text content from a list of URLs. Billed per URL.
      * Returns clean text ready to feed into an LLM context window.
      *
      * @param urls - Array of URLs to fetch (up to 100)
      */
     exaContents(urls: string[]): Promise<ExaContentsResponse>;
     /**
-     * Find pages semantically similar to a given URL. $0.01/call.
+     * Find pages semantically similar to a given URL.
      * Useful for discovering competitors, alternatives, and related resources.
      *
      * @param url - Reference URL
@@ -1454,7 +1454,7 @@ declare class LLMClient {
      * Query Predexon prediction market data (GET endpoints).
      *
      * Access real-time data from Polymarket, Kalshi, dFlow, and Binance Futures.
-     * Powered by Predexon. $0.001 per request.
+     * Powered by Predexon. Billed per request.
      *
      * @param path - Endpoint path, e.g. "polymarket/events", "kalshi/markets/12345"
      * @param params - Query parameters passed to the endpoint
@@ -1469,7 +1469,7 @@ declare class LLMClient {
      * Structured query for Predexon prediction market data (POST endpoints).
      *
      * For endpoints that require a JSON body, e.g. bulk wallet identity lookup.
-     * Tier 1 = $0.001/call, Tier 2 = $0.005/call.
+     * Tier 1 =, Tier 2 =
      *
      * @param path - Endpoint path, e.g. "polymarket/wallet/identities"
      * @param query - JSON body for the structured query
@@ -1502,49 +1502,49 @@ declare class LLMClient {
      * @throws {RetiredEndpointError} always. */
     pmOutcome(_predexonId: string): Promise<Record<string, unknown>>;
     /** Polymarket markets with cursor-based keyset pagination (use pagination_key).
-     * Tier 1 ($0.001/call). */
+     * Tier 1. */
     pmPolymarketMarketsKeyset(params?: Record<string, string>): Promise<Record<string, unknown>>;
     /** Polymarket events with cursor-based keyset pagination (use pagination_key).
-     * Tier 1 ($0.001/call). */
+     * Tier 1. */
     pmPolymarketEventsKeyset(params?: Record<string, string>): Promise<Record<string, unknown>>;
-    /** List available sports categories. Tier 1 ($0.001/call).
+    /** List available sports categories. Tier 1.
      *
      * NOTE: upstream returns 500 for every `sports/*` path as of 2026-08-04.
      * The route still resolves, so this works again the moment Predexon restores
      * it, but do not build on it yet. */
     pmSportsCategories(): Promise<Record<string, unknown>>;
     /** List sports markets grouped by game. Filter with league, sport_type,
-     * status, venue. Tier 1 ($0.001/call).
+     * status, venue. Tier 1.
      *
      * NOTE: upstream returns 500 for every `sports/*` path as of 2026-08-04. */
     pmSportsMarkets(params?: Record<string, string>): Promise<Record<string, unknown>>;
     /** Fetch identity + profile metadata for one wallet (ENS, Twitter, portfolio,
-     * etc.). Tier 2 ($0.005/call). */
+     * etc.). Tier 2. */
     pmWalletIdentity(wallet: string): Promise<Record<string, unknown>>;
-    /** Bulk identity lookup for up to 200 wallet addresses (POST). Tier 2 ($0.005/call). */
+    /** Bulk identity lookup for up to 200 wallet addresses (POST). Tier 2. */
     pmWalletIdentities(addresses: string[]): Promise<Record<string, unknown>>;
     /** Discover wallets connected to a seed address via on-chain transfers and
-     * identity proofs. Tier 2 ($0.005/call). */
+     * identity proofs. Tier 2. */
     pmWalletCluster(address: string): Promise<Record<string, unknown>>;
     /**
      * Query DefiLlama DeFi data (GET passthrough). Powered by DefiLlama.
-     * $0.005/call for protocols / protocol/{slug} / chains / yields;
-     * $0.001/call for prices/{coins}.
+     * for protocols / protocol/{slug} / chains / yields;
+     * for prices/{coins}.
      *
      * @param path - e.g. "protocols", "protocol/aave", "chains", "yields",
      *               "prices/coingecko:bitcoin,base:0x..."
      * @param params - Query parameters passed through to DefiLlama
      */
     defi(path: string, params?: Record<string, string>): Promise<Record<string, unknown>>;
-    /** All DeFi protocols with TVL ($0.005/call). */
+    /** All DeFi protocols with TVL. */
     defiProtocols(): Promise<Record<string, unknown>>;
-    /** Single protocol details + historical TVL ($0.005/call). */
+    /** Single protocol details + historical TVL. */
     defiProtocol(slug: string): Promise<Record<string, unknown>>;
-    /** Current TVL of every chain ($0.005/call). */
+    /** Current TVL of every chain. */
     defiChains(): Promise<Record<string, unknown>>;
-    /** Yield pools with APY/TVL ($0.005/call). */
+    /** Yield pools with APY/TVL. */
     defiYields(params?: Record<string, string>): Promise<Record<string, unknown>>;
-    /** Token price lookup ($0.001/call). Coins like "coingecko:bitcoin" or "{chain}:{address}". */
+    /** Token price lookup. Coins like "coingecko:bitcoin" or "{chain}:{address}". */
     defiPrices(coins: string | string[]): Promise<Record<string, unknown>>;
     /**
      * Query the 0x Swap / Gasless APIs (free — no x402 payment; BlockRun
@@ -1576,18 +1576,18 @@ declare class LLMClient {
     /**
      * Call the Modal sandbox compute API (POST passthrough).
      *
-     * @param path - "sandbox/create" ($0.01 CPU / $0.05 GPU), "sandbox/exec",
-     *               "sandbox/status", "sandbox/terminate" ($0.001 each)
+     * @param path - "sandbox/create" (CPU / GPU tiers), "sandbox/exec",
+     *               "sandbox/status", "sandbox/terminate"
      * @param body - JSON body for the endpoint
      */
     modal(path: string, body?: Record<string, unknown>): Promise<Record<string, unknown>>;
-    /** Create a sandboxed compute environment ($0.01 CPU / $0.05 GPU). */
+    /** Create a sandboxed compute environment (CPU / GPU tiers). */
     modalSandboxCreate(body?: Record<string, unknown>): Promise<Record<string, unknown>>;
-    /** Execute a command in a sandbox; returns stdout/stderr ($0.001). */
+    /** Execute a command in a sandbox; returns stdout/stderr. */
     modalSandboxExec(sandboxId: string, command: string[], extra?: Record<string, unknown>): Promise<Record<string, unknown>>;
-    /** Check a sandbox's status ($0.001). */
+    /** Check a sandbox's status. */
     modalSandboxStatus(sandboxId: string): Promise<Record<string, unknown>>;
-    /** Terminate a sandbox ($0.001). */
+    /** Terminate a sandbox. */
     modalSandboxTerminate(sandboxId: string): Promise<Record<string, unknown>>;
     /**
      * Get current session spending.
@@ -1718,7 +1718,7 @@ declare class ImageClient {
  * Generate full-length ~3 minute music tracks using MiniMax Music 2.5+
  * with automatic x402 micropayments on Base chain.
  *
- * Pricing: $0.1575/track
+ * Pricing: per track — see https://blockrun.ai/models
  * Note: Generated URLs expire in ~24h — download immediately if needed.
  */
 declare class MusicClient {
@@ -1768,7 +1768,7 @@ declare class MusicClient {
  * with automatic x402 micropayments on Base chain.
  *
  * TTS pricing scales with input characters; sound effects are flat
- * $0.05/generation.
+ *
  */
 declare class SpeechClient {
     private _account?;
@@ -1787,7 +1787,7 @@ declare class SpeechClient {
      * Synthesize speech from text (OpenAI-compatible TTS).
      *
      * Price scales with character count: (chars / 1000) x model rate,
-     * minimum $0.001/request. Synthesis is synchronous.
+     * minimum Synthesis is synchronous.
      *
      * @param input - Text to synthesize. Per-model character caps apply
      *                (flash/turbo 40k, multilingual-v2 10k, v3 5k).
@@ -1804,7 +1804,7 @@ declare class SpeechClient {
     /**
      * Generate a cinematic sound effect from a text prompt.
      *
-     * Flat $0.05/generation, up to 22 seconds of audio.
+     *, up to 22 seconds of audio.
      *
      * @param text - Sound effect description (max 1000 chars).
      *               E.g. 'rain on a tin roof', 'sci-fi door whoosh'
@@ -1919,7 +1919,7 @@ declare class VideoClient {
  * Initiates AI-powered outbound phone calls with automatic x402 micropayments
  * on Base chain.
  *
- * Pricing: $0.54 per call (regardless of duration up to max_duration).
+ * Pricing: per call (regardless of duration up to max_duration).
  * Status polling is free.
  */
 declare class VoiceClient {
@@ -1938,7 +1938,7 @@ declare class VoiceClient {
     /**
      * Initiate an AI-powered outbound phone call.
      *
-     * Pricing: $0.54 per call. Returns immediately once the call is queued —
+     * Pricing: per call. Returns immediately once the call is queued —
      * poll getStatus() for transcript and recording.
      *
      * @example
@@ -1990,19 +1990,19 @@ declare class PhoneClient {
     /** Session-cumulative USD spend + call count across this client instance. */
     getSpending(): Spending;
     /**
-     * Carrier + line-type lookup. ~$0.01.
+     * Carrier + line-type lookup.
      *
      * @param phoneNumber E.164 number (e.g. "+14155552671").
      */
     lookup(phoneNumber: string): Promise<PhoneLookupResponse>;
     /**
-     * Lookup + fraud signals (SIM swap, call forwarding). ~$0.05.
+     * Lookup + fraud signals (SIM swap, call forwarding).
      *
      * @param phoneNumber E.164 number.
      */
     lookupFraud(phoneNumber: string): Promise<PhoneLookupResponse>;
     /**
-     * Provision a dedicated phone number for 30 days. $5.00.
+     * Provision a dedicated phone number for 30 days.
      *
      * Payment is settled only after Twilio confirms the purchase, so failed
      * buys never charge your wallet.
@@ -2014,12 +2014,12 @@ declare class PhoneClient {
      */
     buyNumber(options?: PhoneBuyOptions): Promise<PhoneBuyResponse>;
     /**
-     * Extend an existing provisioned number by 30 days. $5.00.
+     * Extend an existing provisioned number by 30 days.
      *
      * @throws {APIError} 403 when the wallet doesn't own the number or it has expired.
      */
     renewNumber(phoneNumber: string): Promise<PhoneRenewResponse>;
-    /** List the wallet's active phone numbers. ~$0.001. */
+    /** List the wallet's active phone numbers. */
     listNumbers(): Promise<PhoneListResponse>;
     /**
      * Release a provisioned number back to the Twilio pool. Free, but still
@@ -2034,7 +2034,7 @@ declare class PhoneClient {
 
 /**
  * Flat enrollment price in USD — mirrors the backend's `ENROLLMENT_PRICE_USD`.
- * Currently $0.01 (promotional, parity with RealFace). The authoritative price
+ * Currently (promotional, parity with RealFace). The authoritative price
  * is whatever the gateway quotes in the 402; this constant is informational.
  */
 declare const PORTRAIT_ENROLLMENT_PRICE_USD = 0.01;
@@ -2063,7 +2063,7 @@ declare class PortraitClient {
     /** Session-cumulative USD spend + call count across this client instance. */
     getSpending(): Spending;
     /**
-     * Enroll a Virtual Portrait from a face image URL. $0.01 (promo).
+     * Enroll a Virtual Portrait from a face image URL. (promo).
      *
      * Payment is settled only after Token360 confirms the enrollment, so failed
      * enrollments never charge your wallet.
@@ -2166,7 +2166,7 @@ declare const NETWORK_ALIASES: Record<string, string>;
  * Standard JSON-RPC 2.0 access to 40+ chains through BlockRun's Tatum
  * gateway with automatic x402 micropayments on Base chain.
  *
- * Flat $0.002 per call; a JSON-RPC batch charges per element.
+ * Flat per call; a JSON-RPC batch charges per element.
  */
 declare class RpcClient {
     private _account?;
@@ -2182,7 +2182,7 @@ declare class RpcClient {
     private sessionCalls;
     constructor(options?: RpcClientOptions);
     /**
-     * Make a single JSON-RPC 2.0 call. Flat $0.002.
+     * Make a single JSON-RPC 2.0 call. Flat per-call rate.
      *
      * @param network - Chain name (e.g. "ethereum", "base", "solana") or a
      *                  common alias ("eth", "sol", "matic", ...). See
@@ -2200,7 +2200,7 @@ declare class RpcClient {
      */
     call<T = unknown>(network: RpcNetwork, method: string, params?: unknown[]): Promise<RpcResponse<T>>;
     /**
-     * Make a JSON-RPC 2.0 batch call. Priced per element ($0.002 x N).
+     * Make a JSON-RPC 2.0 batch call. Priced per element (rate x N).
      *
      * @param network - Chain name or alias (see {@link call}).
      * @param requests - Requests, each with a `method` and optional
@@ -2682,28 +2682,28 @@ declare class SolanaLLMClient {
      */
     exa(path: string, body: Record<string, unknown>): Promise<Record<string, unknown>>;
     /**
-     * Neural and keyword web search via Exa (Solana payment, $0.01/request).
+     * Neural and keyword web search via Exa (Solana payment).
      *
      * @example
      * const results = await client.exaSearch("latest AI papers", { numResults: 5 });
      */
     exaSearch(query: string, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
     /**
-     * Find pages semantically similar to a given URL via Exa (Solana payment, $0.01/request).
+     * Find pages semantically similar to a given URL via Exa (Solana payment).
      *
      * @example
      * const results = await client.exaFindSimilar("https://openai.com/research/gpt-4", { numResults: 5 });
      */
     exaFindSimilar(url: string, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
     /**
-     * Extract full text content from URLs via Exa (Solana payment, $0.002/URL).
+     * Extract full text content from URLs via Exa (Solana payment).
      *
      * @example
      * const data = await client.exaContents(["https://arxiv.org/abs/2303.08774"]);
      */
     exaContents(urls: string[], options?: Record<string, unknown>): Promise<Record<string, unknown>>;
     /**
-     * AI-generated answer grounded in live web search via Exa (Solana payment, $0.01/request).
+     * AI-generated answer grounded in live web search via Exa (Solana payment).
      *
      * @example
      * const answer = await client.exaAnswer("What is the current state of AI safety research?");
@@ -2711,23 +2711,23 @@ declare class SolanaLLMClient {
     exaAnswer(query: string, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
     /**
      * Query DefiLlama DeFi data (GET passthrough). Powered by DefiLlama.
-     * $0.005/call for protocols / protocol/{slug} / chains / yields;
-     * $0.001/call for prices/{coins}.
+     * for protocols / protocol/{slug} / chains / yields;
+     * for prices/{coins}.
      *
      * @param path - e.g. "protocols", "protocol/aave", "chains", "yields",
      *               "prices/coingecko:bitcoin,base:0x..."
      * @param params - Query parameters passed through to DefiLlama
      */
     defi(path: string, params?: Record<string, string>): Promise<Record<string, unknown>>;
-    /** All DeFi protocols with TVL ($0.005/call). */
+    /** All DeFi protocols with TVL. */
     defiProtocols(): Promise<Record<string, unknown>>;
-    /** Single protocol details + historical TVL ($0.005/call). */
+    /** Single protocol details + historical TVL. */
     defiProtocol(slug: string): Promise<Record<string, unknown>>;
-    /** Current TVL of every chain ($0.005/call). */
+    /** Current TVL of every chain. */
     defiChains(): Promise<Record<string, unknown>>;
-    /** Yield pools with APY/TVL ($0.005/call). */
+    /** Yield pools with APY/TVL. */
     defiYields(params?: Record<string, string>): Promise<Record<string, unknown>>;
-    /** Token price lookup ($0.001/call). Coins like "coingecko:bitcoin" or "{chain}:{address}". */
+    /** Token price lookup. Coins like "coingecko:bitcoin" or "{chain}:{address}". */
     defiPrices(coins: string | string[]): Promise<Record<string, unknown>>;
     /**
      * Query the 0x Swap / Gasless APIs (free — no x402 payment; BlockRun
@@ -2759,18 +2759,18 @@ declare class SolanaLLMClient {
     /**
      * Call the Modal sandbox compute API (POST passthrough).
      *
-     * @param path - "sandbox/create" ($0.01 CPU / $0.05 GPU), "sandbox/exec",
-     *               "sandbox/status", "sandbox/terminate" ($0.001 each)
+     * @param path - "sandbox/create" (CPU / GPU tiers), "sandbox/exec",
+     *               "sandbox/status", "sandbox/terminate"
      * @param body - JSON body for the endpoint
      */
     modal(path: string, body?: Record<string, unknown>): Promise<Record<string, unknown>>;
-    /** Create a sandboxed compute environment ($0.01 CPU / $0.05 GPU). */
+    /** Create a sandboxed compute environment (CPU / GPU tiers). */
     modalSandboxCreate(body?: Record<string, unknown>): Promise<Record<string, unknown>>;
-    /** Execute a command in a sandbox; returns stdout/stderr ($0.001). */
+    /** Execute a command in a sandbox; returns stdout/stderr. */
     modalSandboxExec(sandboxId: string, command: string[], extra?: Record<string, unknown>): Promise<Record<string, unknown>>;
-    /** Check a sandbox's status ($0.001). */
+    /** Check a sandbox's status. */
     modalSandboxStatus(sandboxId: string): Promise<Record<string, unknown>>;
-    /** Terminate a sandbox ($0.001). */
+    /** Terminate a sandbox. */
     modalSandboxTerminate(sandboxId: string): Promise<Record<string, unknown>>;
     /** Get session spending. */
     getSpending(): Spending;