@blockrun/llm 3.17.1 → 3.19.0

package/dist/index.d.cts

@@ -770,6 +770,10 @@ interface VideoClip {
     request_id?: string;
     /** True when the gateway mirrored the video to its GCS bucket */
     backed_up?: boolean;
+    /** Final frame image when returnLastFrame is requested and the provider returns it. */
+    last_frame_url?: string;
+    /** Whether the final frame was mirrored to BlockRun storage. */
+    last_frame_backed_up?: boolean;
 }
 interface VideoResponse {
     created: number;
@@ -813,18 +817,55 @@ interface VideoGenerateOptions {
      * First-and-last-frame interpolation: a second image that seeds the FINAL
      * frame so the model tweens from `imageUrl` → `lastFrameUrl`. Requires
      * `imageUrl` (the first frame) and a Seedance model
-     * (bytedance/seedance-1.5-pro, seedance-2.0, or seedance-2.0-fast).
+     * (1.5-pro, 2.0 / Fast / Mini, or 2.5).
      * Priced identically to image-to-video. Mutually exclusive with
      * `realFaceAssetId`.
      */
     lastFrameUrl?: string;
     /**
-     * Omni / multi-reference: up to 9 reference image URLs for character/style
-     * consistency (**Seedance 2.0 only**). Cite them as "image 1", "image 2"
-     * in the prompt. Mutually exclusive with `imageUrl` / `lastFrameUrl` /
-     * `realFaceAssetId`.
+     * Omni / multi-reference: up to 9 (Seedance 2.0 / Fast / Mini) or 30
+     * (Seedance 2.5) reference image URLs for character/style consistency. Cite
+     * them as "image 1", "image 2" in the prompt. Mutually exclusive with
+     * `imageUrl` / `lastFrameUrl` / `realFaceAssetId`.
+     *
+     * **Account API key only.** Reference media is served by `api.blockrun.ai`;
+     * the wallet gateways (blockrun.ai, sol.blockrun.ai) refuse it with a 400
+     * before any payment.
      */
     referenceImageUrls?: string[];
+    /**
+     * Reference-to-video: 1–3 http(s) motion/style video clips (Seedance 2.0 /
+     * Fast / Mini). May be combined with `referenceImageUrls`; mutually exclusive
+     * with frame seeds. `role` is optional and, when set, must be `"reference"`.
+     * Adds a per-clip surcharge. **Account API key only** (see `referenceImageUrls`).
+     */
+    referenceVideos?: Array<{
+        url: string;
+        role?: "reference";
+    }>;
+    /**
+     * Reference audio: 1–3 http(s) clips, each ≤15.2s (Seedance 2.0 / Fast /
+     * Mini). Requires `referenceImageUrls` or `referenceVideos` alongside it.
+     * Adds a per-clip surcharge. **Account API key only** (see `referenceImageUrls`).
+     */
+    referenceAudios?: Array<{
+        url: string;
+        role?: "reference";
+    }>;
+    /** Output bitrate mode. Seedance 2.0 / Fast / Mini / 2.5 only — other models get a 400. */
+    bitrateMode?: "standard" | "high";
+    /** Output container. Seedance 2.5 only — other models get a 400. */
+    outputFormat?: "mp4" | "mov";
+    /** Lock the camera. Seedance 1.5-pro only — other models get a 400. */
+    cameraFixed?: boolean;
+    /** End-user identifier forwarded for upstream abuse monitoring. Seedance only. */
+    safetyIdentifier?: string;
+    /**
+     * Declare the intended mode. The gateway infers it from the media fields
+     * anyway; when this is set and disagrees, it answers 400 (with the inferred
+     * mode) before payment instead of rendering the wrong thing.
+     */
+    inputType?: "text" | "image" | "first_last_frame" | "reference";
     /** Duration to bill for (defaults to model's default duration) */
     durationSeconds?: number;
     /** Output aspect ratio. Token360 / Seedance only — silently ignored by xAI Grok. */
@@ -844,7 +885,10 @@ interface VideoGenerateOptions {
     seed?: number;
     /** Embed the upstream watermark on the output. Defaults to false at the gateway. */
     watermark?: boolean;
-    /** Return the last frame as an image alongside the clip — useful for chaining. */
+    /**
+     * Return the last frame as an image alongside the clip — useful for chaining.
+     * Read it from `data[0].last_frame_url` (absent if the upstream omits it).
+     */
     returnLastFrame?: boolean;
 }
 interface SearchOptions {
@@ -1869,8 +1913,11 @@ declare class VideoClient {
      * Generate a video from a standard Seedance `content[]` body.
      *
      * Targets the gateway's `POST /v1/videos` endpoint, which accepts the
-     * mainstream multimodal `content` array (text + a single reference image)
-     * used by other Seedance APIs — so callers already holding a
+     * mainstream multimodal `content` array used by other Seedance APIs. Items
+     * may carry a `role` — `first_frame`, `last_frame`, `reference_image`,
+     * `reference_video`, `reference_audio` — which the gateway maps to the same
+     * validated fields as {@link generate}; a role-less single image keeps its
+     * first-frame meaning — so callers already holding a
      * `content[]`-shaped request can submit it unchanged. The gateway validates
      * unsupported inputs *before* charging, then delegates to the same x402
      * submit+poll pipeline as {@link generate}.
@@ -1884,7 +1931,8 @@ declare class VideoClient {
      *   `{ type: "image_url", image_url: { url: "https://..." } }`.
      * @param options - `model`, `budgetMs`, plus the same camelCase render options
      *   as {@link generate} (`durationSeconds`, `aspectRatio`, `resolution`,
-     *   `generateAudio`, `seed`, `watermark`, `returnLastFrame`). These are mapped
+     *   `generateAudio`, `seed`, `watermark`, `returnLastFrame`, `bitrateMode`,
+     *   `outputFormat`, `cameraFixed`, `safetyIdentifier`, `inputType`). These are mapped
      *   to the gateway's snake_case fields for you. Any other keys you pass are
      *   forwarded verbatim (use snake_case for those, since the gateway reads
      *   snake_case only).
@@ -1899,6 +1947,11 @@ declare class VideoClient {
         seed?: number;
         watermark?: boolean;
         returnLastFrame?: boolean;
+        bitrateMode?: "standard" | "high";
+        outputFormat?: "mp4" | "mov";
+        cameraFixed?: boolean;
+        safetyIdentifier?: string;
+        inputType?: "text" | "image" | "first_last_frame" | "reference";
     } & Record<string, unknown>): Promise<VideoResponse>;
     private submitAndPoll;
     /**
@@ -2651,6 +2704,31 @@ declare function formatFundingMessageCompact(address: string): string;
 declare const WALLET_FILE_PATH: string;
 declare const WALLET_DIR_PATH: string;
 
+/** Opt-in configuration for Solana batch-settlement. */
+interface SolanaBatchOptions {
+    /**
+     * Base58 operator public keys you trust to sign vouchers against your
+     * channel. A batch accept naming any other operator is ignored, and the
+     * call pays with `exact`. Required: there is no built-in default key.
+     */
+    operators: string[];
+    /**
+     * Total escrow, in USD, this client will lock in one channel (the first
+     * deposit plus every top-up). This is the most an operator could take
+     * without another signature from you. Accepts `"$5"`, `"5"` or `5`.
+     * Default `"$1"` (the `@x402/svm` default).
+     */
+    maxDeposit?: string | number;
+    /**
+     * Where open-channel state is persisted between processes.
+     * - default: `~/.blockrun/solana-batch/<wallet address>.json` (mode 0600)
+     * - a path: that file
+     * - `false`: in memory only. On restart the client finds its channel again
+     *   by scanning the chain for it.
+     */
+    channelStore?: string | false;
+}
+
 interface SolanaLLMClientOptions extends ApiKeyOptions {
     /** bs58-encoded Solana secret key (64 bytes). Optional if SOLANA_WALLET_KEY env var is set. */
     privateKey?: string;
@@ -2673,6 +2751,14 @@ interface SolanaLLMClientOptions extends ApiKeyOptions {
     rpcHeaders?: Record<string, string>;
     /** Request timeout in milliseconds (default: 60000) */
     timeout?: number;
+    /**
+     * Opt in to x402 batch-settlement (metered billing) for chat completions.
+     * Each call is charged what it actually cost, at most its quoted ceiling,
+     * from a deposit-backed payment channel instead of a per-call transfer.
+     * Needs the optional peers `@x402/core`, `@x402/svm` and `@solana/kit`.
+     * Ignored in API-key mode. See {@link SolanaBatchOptions}.
+     */
+    batch?: SolanaBatchOptions;
 }
 declare class SolanaLLMClient {
     static readonly SOLANA_API_URL = "https://sol.blockrun.ai/api";
@@ -2689,7 +2775,16 @@ declare class SolanaLLMClient {
     private addressCache;
     private modelPricingCache;
     private modelPricingPromise;
+    private batchPayer?;
     constructor(options?: SolanaLLMClientOptions);
+    /**
+     * Close this wallet's batch-settlement channel and return its unused escrow.
+     *
+     * The gateway closes it cooperatively when it can; otherwise this starts a
+     * payer-forced close and the escrow comes back after the channel's grace
+     * period. Only meaningful with the `batch` option.
+     */
+    closeBatchChannel(): Promise<unknown>;
     /** Get Solana wallet address (public key in base58). */
     getWalletAddress(): Promise<string>;
     /** Simple 1-line chat. */
@@ -2919,7 +3014,7 @@ declare class SolanaLLMClient {
      * @throws PaymentError when the 402 carries no usable Solana requirements.
      */
     /**
-     * Follow a 202 `{ id, poll_url }` to completion, on Solana.
+     * Follow a 202 `{ id, poll_url }` to completion, on Solana **image** routes.
      *
      * Two things differ from Base and both come from the same constraint — a
      * Solana payment is a transaction pinned to a recent blockhash, valid for
@@ -2930,6 +3025,9 @@ declare class SolanaLLMClient {
      *    settles optimistically at submit, and this loop only fetches the result.
      *    The cost is recorded by the caller at POST, never here — recording it on
      *    completion would lose the charge whenever a paid job then fails.
+     *    Solana VIDEO is the exception: it settles on the completed poll and a
+     *    failed job is not charged. Do not route video through this loop as-is —
+     *    it would book spend for jobs that were never charged.
      * 2. **Every poll re-signs.** One authorization cannot be replayed across a
      *    long render. The gateway binds the job to the payer address rather than
      *    to the signature, so a fresh signature from the same wallet is accepted
@@ -2937,6 +3035,10 @@ declare class SolanaLLMClient {
      */
     private followSolanaJob;
     private signPaymentFrom402;
+    /** Read a `402`'s payment requirements from its header, or its JSON body. */
+    private readPaymentRequired;
+    /** Sign the `exact` accept of a 402 as an SPL TransferChecked payment. */
+    private signExactPayment;
     private handlePaymentAndRetry;
     private requestWithPaymentRaw;
     private handlePaymentAndRetryRaw;
@@ -3319,4 +3421,4 @@ declare function validateTemperature(temperature?: number): void;
  */
 declare function validateTopP(topP?: number): void;
 
-export { APIError, API_KEY_URL, ARC_CHAIN_ID, AnthropicClient, type ApiKeyOptions, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, EVM_NETWORKS, type EvmNetwork, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTAL_URL, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, RetiredEndpointError, type RoutingDecision, type RoutingProfile, type RoutingTaskType, type RoutingTier, type RoutingTierConfig, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatCompletionOptions, type SmartChatCompletionResponse, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_ARC, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, evmNetwork, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentClient, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };
+export { APIError, API_KEY_URL, ARC_CHAIN_ID, AnthropicClient, type ApiKeyOptions, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, EVM_NETWORKS, type EvmNetwork, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTAL_URL, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, RetiredEndpointError, type RoutingDecision, type RoutingProfile, type RoutingTaskType, type RoutingTier, type RoutingTierConfig, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatCompletionOptions, type SmartChatCompletionResponse, type SmartChatOptions, type SmartChatResponse, type SolanaBatchOptions, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_ARC, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, evmNetwork, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentClient, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };

package/dist/index.d.ts

@@ -770,6 +770,10 @@ interface VideoClip {
     request_id?: string;
     /** True when the gateway mirrored the video to its GCS bucket */
     backed_up?: boolean;
+    /** Final frame image when returnLastFrame is requested and the provider returns it. */
+    last_frame_url?: string;
+    /** Whether the final frame was mirrored to BlockRun storage. */
+    last_frame_backed_up?: boolean;
 }
 interface VideoResponse {
     created: number;
@@ -813,18 +817,55 @@ interface VideoGenerateOptions {
      * First-and-last-frame interpolation: a second image that seeds the FINAL
      * frame so the model tweens from `imageUrl` → `lastFrameUrl`. Requires
      * `imageUrl` (the first frame) and a Seedance model
-     * (bytedance/seedance-1.5-pro, seedance-2.0, or seedance-2.0-fast).
+     * (1.5-pro, 2.0 / Fast / Mini, or 2.5).
      * Priced identically to image-to-video. Mutually exclusive with
      * `realFaceAssetId`.
      */
     lastFrameUrl?: string;
     /**
-     * Omni / multi-reference: up to 9 reference image URLs for character/style
-     * consistency (**Seedance 2.0 only**). Cite them as "image 1", "image 2"
-     * in the prompt. Mutually exclusive with `imageUrl` / `lastFrameUrl` /
-     * `realFaceAssetId`.
+     * Omni / multi-reference: up to 9 (Seedance 2.0 / Fast / Mini) or 30
+     * (Seedance 2.5) reference image URLs for character/style consistency. Cite
+     * them as "image 1", "image 2" in the prompt. Mutually exclusive with
+     * `imageUrl` / `lastFrameUrl` / `realFaceAssetId`.
+     *
+     * **Account API key only.** Reference media is served by `api.blockrun.ai`;
+     * the wallet gateways (blockrun.ai, sol.blockrun.ai) refuse it with a 400
+     * before any payment.
      */
     referenceImageUrls?: string[];
+    /**
+     * Reference-to-video: 1–3 http(s) motion/style video clips (Seedance 2.0 /
+     * Fast / Mini). May be combined with `referenceImageUrls`; mutually exclusive
+     * with frame seeds. `role` is optional and, when set, must be `"reference"`.
+     * Adds a per-clip surcharge. **Account API key only** (see `referenceImageUrls`).
+     */
+    referenceVideos?: Array<{
+        url: string;
+        role?: "reference";
+    }>;
+    /**
+     * Reference audio: 1–3 http(s) clips, each ≤15.2s (Seedance 2.0 / Fast /
+     * Mini). Requires `referenceImageUrls` or `referenceVideos` alongside it.
+     * Adds a per-clip surcharge. **Account API key only** (see `referenceImageUrls`).
+     */
+    referenceAudios?: Array<{
+        url: string;
+        role?: "reference";
+    }>;
+    /** Output bitrate mode. Seedance 2.0 / Fast / Mini / 2.5 only — other models get a 400. */
+    bitrateMode?: "standard" | "high";
+    /** Output container. Seedance 2.5 only — other models get a 400. */
+    outputFormat?: "mp4" | "mov";
+    /** Lock the camera. Seedance 1.5-pro only — other models get a 400. */
+    cameraFixed?: boolean;
+    /** End-user identifier forwarded for upstream abuse monitoring. Seedance only. */
+    safetyIdentifier?: string;
+    /**
+     * Declare the intended mode. The gateway infers it from the media fields
+     * anyway; when this is set and disagrees, it answers 400 (with the inferred
+     * mode) before payment instead of rendering the wrong thing.
+     */
+    inputType?: "text" | "image" | "first_last_frame" | "reference";
     /** Duration to bill for (defaults to model's default duration) */
     durationSeconds?: number;
     /** Output aspect ratio. Token360 / Seedance only — silently ignored by xAI Grok. */
@@ -844,7 +885,10 @@ interface VideoGenerateOptions {
     seed?: number;
     /** Embed the upstream watermark on the output. Defaults to false at the gateway. */
     watermark?: boolean;
-    /** Return the last frame as an image alongside the clip — useful for chaining. */
+    /**
+     * Return the last frame as an image alongside the clip — useful for chaining.
+     * Read it from `data[0].last_frame_url` (absent if the upstream omits it).
+     */
     returnLastFrame?: boolean;
 }
 interface SearchOptions {
@@ -1869,8 +1913,11 @@ declare class VideoClient {
      * Generate a video from a standard Seedance `content[]` body.
      *
      * Targets the gateway's `POST /v1/videos` endpoint, which accepts the
-     * mainstream multimodal `content` array (text + a single reference image)
-     * used by other Seedance APIs — so callers already holding a
+     * mainstream multimodal `content` array used by other Seedance APIs. Items
+     * may carry a `role` — `first_frame`, `last_frame`, `reference_image`,
+     * `reference_video`, `reference_audio` — which the gateway maps to the same
+     * validated fields as {@link generate}; a role-less single image keeps its
+     * first-frame meaning — so callers already holding a
      * `content[]`-shaped request can submit it unchanged. The gateway validates
      * unsupported inputs *before* charging, then delegates to the same x402
      * submit+poll pipeline as {@link generate}.
@@ -1884,7 +1931,8 @@ declare class VideoClient {
      *   `{ type: "image_url", image_url: { url: "https://..." } }`.
      * @param options - `model`, `budgetMs`, plus the same camelCase render options
      *   as {@link generate} (`durationSeconds`, `aspectRatio`, `resolution`,
-     *   `generateAudio`, `seed`, `watermark`, `returnLastFrame`). These are mapped
+     *   `generateAudio`, `seed`, `watermark`, `returnLastFrame`, `bitrateMode`,
+     *   `outputFormat`, `cameraFixed`, `safetyIdentifier`, `inputType`). These are mapped
      *   to the gateway's snake_case fields for you. Any other keys you pass are
      *   forwarded verbatim (use snake_case for those, since the gateway reads
      *   snake_case only).
@@ -1899,6 +1947,11 @@ declare class VideoClient {
         seed?: number;
         watermark?: boolean;
         returnLastFrame?: boolean;
+        bitrateMode?: "standard" | "high";
+        outputFormat?: "mp4" | "mov";
+        cameraFixed?: boolean;
+        safetyIdentifier?: string;
+        inputType?: "text" | "image" | "first_last_frame" | "reference";
     } & Record<string, unknown>): Promise<VideoResponse>;
     private submitAndPoll;
     /**
@@ -2651,6 +2704,31 @@ declare function formatFundingMessageCompact(address: string): string;
 declare const WALLET_FILE_PATH: string;
 declare const WALLET_DIR_PATH: string;
 
+/** Opt-in configuration for Solana batch-settlement. */
+interface SolanaBatchOptions {
+    /**
+     * Base58 operator public keys you trust to sign vouchers against your
+     * channel. A batch accept naming any other operator is ignored, and the
+     * call pays with `exact`. Required: there is no built-in default key.
+     */
+    operators: string[];
+    /**
+     * Total escrow, in USD, this client will lock in one channel (the first
+     * deposit plus every top-up). This is the most an operator could take
+     * without another signature from you. Accepts `"$5"`, `"5"` or `5`.
+     * Default `"$1"` (the `@x402/svm` default).
+     */
+    maxDeposit?: string | number;
+    /**
+     * Where open-channel state is persisted between processes.
+     * - default: `~/.blockrun/solana-batch/<wallet address>.json` (mode 0600)
+     * - a path: that file
+     * - `false`: in memory only. On restart the client finds its channel again
+     *   by scanning the chain for it.
+     */
+    channelStore?: string | false;
+}
+
 interface SolanaLLMClientOptions extends ApiKeyOptions {
     /** bs58-encoded Solana secret key (64 bytes). Optional if SOLANA_WALLET_KEY env var is set. */
     privateKey?: string;
@@ -2673,6 +2751,14 @@ interface SolanaLLMClientOptions extends ApiKeyOptions {
     rpcHeaders?: Record<string, string>;
     /** Request timeout in milliseconds (default: 60000) */
     timeout?: number;
+    /**
+     * Opt in to x402 batch-settlement (metered billing) for chat completions.
+     * Each call is charged what it actually cost, at most its quoted ceiling,
+     * from a deposit-backed payment channel instead of a per-call transfer.
+     * Needs the optional peers `@x402/core`, `@x402/svm` and `@solana/kit`.
+     * Ignored in API-key mode. See {@link SolanaBatchOptions}.
+     */
+    batch?: SolanaBatchOptions;
 }
 declare class SolanaLLMClient {
     static readonly SOLANA_API_URL = "https://sol.blockrun.ai/api";
@@ -2689,7 +2775,16 @@ declare class SolanaLLMClient {
     private addressCache;
     private modelPricingCache;
     private modelPricingPromise;
+    private batchPayer?;
     constructor(options?: SolanaLLMClientOptions);
+    /**
+     * Close this wallet's batch-settlement channel and return its unused escrow.
+     *
+     * The gateway closes it cooperatively when it can; otherwise this starts a
+     * payer-forced close and the escrow comes back after the channel's grace
+     * period. Only meaningful with the `batch` option.
+     */
+    closeBatchChannel(): Promise<unknown>;
     /** Get Solana wallet address (public key in base58). */
     getWalletAddress(): Promise<string>;
     /** Simple 1-line chat. */
@@ -2919,7 +3014,7 @@ declare class SolanaLLMClient {
      * @throws PaymentError when the 402 carries no usable Solana requirements.
      */
     /**
-     * Follow a 202 `{ id, poll_url }` to completion, on Solana.
+     * Follow a 202 `{ id, poll_url }` to completion, on Solana **image** routes.
      *
      * Two things differ from Base and both come from the same constraint — a
      * Solana payment is a transaction pinned to a recent blockhash, valid for
@@ -2930,6 +3025,9 @@ declare class SolanaLLMClient {
      *    settles optimistically at submit, and this loop only fetches the result.
      *    The cost is recorded by the caller at POST, never here — recording it on
      *    completion would lose the charge whenever a paid job then fails.
+     *    Solana VIDEO is the exception: it settles on the completed poll and a
+     *    failed job is not charged. Do not route video through this loop as-is —
+     *    it would book spend for jobs that were never charged.
      * 2. **Every poll re-signs.** One authorization cannot be replayed across a
      *    long render. The gateway binds the job to the payer address rather than
      *    to the signature, so a fresh signature from the same wallet is accepted
@@ -2937,6 +3035,10 @@ declare class SolanaLLMClient {
      */
     private followSolanaJob;
     private signPaymentFrom402;
+    /** Read a `402`'s payment requirements from its header, or its JSON body. */
+    private readPaymentRequired;
+    /** Sign the `exact` accept of a 402 as an SPL TransferChecked payment. */
+    private signExactPayment;
     private handlePaymentAndRetry;
     private requestWithPaymentRaw;
     private handlePaymentAndRetryRaw;
@@ -3319,4 +3421,4 @@ declare function validateTemperature(temperature?: number): void;
  */
 declare function validateTopP(topP?: number): void;
 
-export { APIError, API_KEY_URL, ARC_CHAIN_ID, AnthropicClient, type ApiKeyOptions, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, EVM_NETWORKS, type EvmNetwork, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTAL_URL, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, RetiredEndpointError, type RoutingDecision, type RoutingProfile, type RoutingTaskType, type RoutingTier, type RoutingTierConfig, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatCompletionOptions, type SmartChatCompletionResponse, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_ARC, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, evmNetwork, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentClient, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };
+export { APIError, API_KEY_URL, ARC_CHAIN_ID, AnthropicClient, type ApiKeyOptions, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, EVM_NETWORKS, type EvmNetwork, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTAL_URL, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, RetiredEndpointError, type RoutingDecision, type RoutingProfile, type RoutingTaskType, type RoutingTier, type RoutingTierConfig, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatCompletionOptions, type SmartChatCompletionResponse, type SmartChatOptions, type SmartChatResponse, type SolanaBatchOptions, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_ARC, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, evmNetwork, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentClient, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };