@openrouter/sdk 0.12.3 → 0.12.5

package/esm/models/percentilethroughputcutoffs.d.ts

@@ -6,26 +6,26 @@ export type PercentileThroughputCutoffs = {
     /**
      * Minimum p50 throughput (tokens/sec)
      */
-    p50?: number | undefined;
+    p50?: number | null | undefined;
     /**
      * Minimum p75 throughput (tokens/sec)
      */
-    p75?: number | undefined;
+    p75?: number | null | undefined;
     /**
      * Minimum p90 throughput (tokens/sec)
      */
-    p90?: number | undefined;
+    p90?: number | null | undefined;
     /**
      * Minimum p99 throughput (tokens/sec)
      */
-    p99?: number | undefined;
+    p99?: number | null | undefined;
 };
 /** @internal */
 export type PercentileThroughputCutoffs$Outbound = {
-    p50?: number | undefined;
-    p75?: number | undefined;
-    p90?: number | undefined;
-    p99?: number | undefined;
+    p50?: number | null | undefined;
+    p75?: number | null | undefined;
+    p90?: number | null | undefined;
+    p99?: number | null | undefined;
 };
 /** @internal */
 export declare const PercentileThroughputCutoffs$outboundSchema: z.ZodType<PercentileThroughputCutoffs$Outbound, PercentileThroughputCutoffs>;

package/esm/models/percentilethroughputcutoffs.js

@@ -5,10 +5,10 @@
 import * as z from "zod/v4";
 /** @internal */
 export const PercentileThroughputCutoffs$outboundSchema = z.object({
-    p50: z.number().optional(),
-    p75: z.number().optional(),
-    p90: z.number().optional(),
-    p99: z.number().optional(),
+    p50: z.nullable(z.number()).optional(),
+    p75: z.nullable(z.number()).optional(),
+    p90: z.nullable(z.number()).optional(),
+    p99: z.nullable(z.number()).optional(),
 });
 export function percentileThroughputCutoffsToJSON(percentileThroughputCutoffs) {
     return JSON.stringify(PercentileThroughputCutoffs$outboundSchema.parse(percentileThroughputCutoffs));

package/esm/models/publicendpoint.d.ts

@@ -43,8 +43,8 @@ export type PublicEndpoint = {
      * Latency percentiles in milliseconds over the last 30 minutes. Latency measures time to first token. Only visible when authenticated with an API key or cookie; returns null for unauthenticated requests.
      */
     latencyLast30m: PercentileStats | null;
-    maxCompletionTokens: number;
-    maxPromptTokens: number;
+    maxCompletionTokens: number | null;
+    maxPromptTokens: number | null;
     /**
      * The unique identifier for the model (permaslug)
      */
@@ -62,12 +62,12 @@ export type PublicEndpoint = {
     /**
      * Uptime percentage over the last 1 day, calculated as successful requests / (successful + error requests) * 100. Rate-limited requests are excluded. Returns null if insufficient data.
      */
-    uptimeLast1d: number;
-    uptimeLast30m: number;
+    uptimeLast1d: number | null;
+    uptimeLast30m: number | null;
     /**
      * Uptime percentage over the last 5 minutes, calculated as successful requests / (successful + error requests) * 100. Rate-limited requests are excluded. Returns null if insufficient data.
      */
-    uptimeLast5m: number;
+    uptimeLast5m: number | null;
 };
 /** @internal */
 export declare const Pricing$inboundSchema: z.ZodType<Pricing, unknown>;

package/esm/models/publicendpoint.js

@@ -58,8 +58,8 @@ export const PublicEndpointQuantization$inboundSchema = openEnums.inboundSchema(
 export const PublicEndpoint$inboundSchema = z.object({
     context_length: z.int(),
     latency_last_30m: z.nullable(PercentileStats$inboundSchema),
-    max_completion_tokens: z.int(),
-    max_prompt_tokens: z.int(),
+    max_completion_tokens: z.nullable(z.int()),
+    max_prompt_tokens: z.nullable(z.int()),
     model_id: z.string(),
     model_name: z.string(),
     name: z.string(),
@@ -71,9 +71,9 @@ export const PublicEndpoint$inboundSchema = z.object({
     supports_implicit_caching: z.boolean(),
     tag: z.string(),
     throughput_last_30m: z.nullable(PercentileStats$inboundSchema),
-    uptime_last_1d: z.number(),
-    uptime_last_30m: z.number(),
-    uptime_last_5m: z.number(),
+    uptime_last_1d: z.nullable(z.number()),
+    uptime_last_30m: z.nullable(z.number()),
+    uptime_last_5m: z.nullable(z.number()),
 }).transform((v) => {
     return remap$(v, {
         "context_length": "contextLength",

package/esm/models/reasoningconfig.d.ts

@@ -8,14 +8,14 @@ export type ReasoningConfig = {
     effort?: ReasoningEffort | null | undefined;
     summary?: ReasoningSummaryVerbosity | null | undefined;
     enabled?: boolean | null | undefined;
-    maxTokens?: number | undefined;
+    maxTokens?: number | null | undefined;
 };
 /** @internal */
 export type ReasoningConfig$Outbound = {
     effort?: string | null | undefined;
     summary?: string | null | undefined;
     enabled?: boolean | null | undefined;
-    max_tokens?: number | undefined;
+    max_tokens?: number | null | undefined;
 };
 /** @internal */
 export declare const ReasoningConfig$outboundSchema: z.ZodType<ReasoningConfig$Outbound, ReasoningConfig>;

package/esm/models/reasoningconfig.js

@@ -11,7 +11,7 @@ export const ReasoningConfig$outboundSchema = z.object({
     effort: z.nullable(ReasoningEffort$outboundSchema).optional(),
     summary: z.nullable(ReasoningSummaryVerbosity$outboundSchema).optional(),
     enabled: z.nullable(z.boolean()).optional(),
-    maxTokens: z.int().optional(),
+    maxTokens: z.nullable(z.int()).optional(),
 }).transform((v) => {
     return remap$(v, {
         maxTokens: "max_tokens",

package/esm/models/responsesrequest.d.ts

@@ -11,7 +11,9 @@ import { CustomTool, CustomTool$Outbound } from "./customtool.js";
 import { DatetimeServerTool, DatetimeServerTool$Outbound } from "./datetimeservertool.js";
 import { FileParserPlugin, FileParserPlugin$Outbound } from "./fileparserplugin.js";
 import { FileSearchServerTool, FileSearchServerTool$Outbound } from "./filesearchservertool.js";
+import { ImageConfig, ImageConfig$Outbound } from "./imageconfig.js";
 import { ImageGenerationServerTool, ImageGenerationServerTool$Outbound } from "./imagegenerationservertool.js";
+import { ImageGenerationServerToolOpenRouter, ImageGenerationServerToolOpenRouter$Outbound } from "./imagegenerationservertoolopenrouter.js";
 import { InputsUnion, InputsUnion$Outbound } from "./inputsunion.js";
 import { LegacyWebSearchServerTool, LegacyWebSearchServerTool$Outbound } from "./legacywebsearchservertool.js";
 import { McpServerTool, McpServerTool$Outbound } from "./mcpservertool.js";
@@ -32,7 +34,6 @@ import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
 import { WebSearchPlugin, WebSearchPlugin$Outbound } from "./websearchplugin.js";
 import { WebSearchServerTool, WebSearchServerTool$Outbound } from "./websearchservertool.js";
 import { WebSearchServerToolOpenRouter, WebSearchServerToolOpenRouter$Outbound } from "./websearchservertoolopenrouter.js";
-export type ResponsesRequestImageConfig = string | number;
 export type ResponsesRequestPlugin = AutoRouterPlugin | ContextCompressionPlugin | FileParserPlugin | ModerationPlugin | ResponseHealingPlugin | WebSearchPlugin;
 export declare const ResponsesRequestServiceTier: {
     readonly Auto: "auto";
@@ -56,6 +57,8 @@ export type ResponsesRequestToolFunction = {
 };
 export type ResponsesRequestToolUnion = ResponsesRequestToolFunction | PreviewWebSearchServerTool | Preview20250311WebSearchServerTool | LegacyWebSearchServerTool | WebSearchServerTool | FileSearchServerTool | ComputerUseServerTool | CodeInterpreterServerTool | McpServerTool | ImageGenerationServerTool | CodexLocalShellTool | ShellServerTool | ApplyPatchServerTool | CustomTool | (DatetimeServerTool & {
     type: "openrouter:datetime";
+}) | (ImageGenerationServerToolOpenRouter & {
+    type: "openrouter:image_generation";
 }) | (ChatSearchModelsServerTool & {
     type: "openrouter:experimental__search_models";
 }) | WebSearchServerToolOpenRouter;
@@ -64,12 +67,12 @@ export type ResponsesRequestToolUnion = ResponsesRequestToolFunction | PreviewWe
  */
 export type ResponsesRequest = {
     background?: boolean | null | undefined;
-    frequencyPenalty?: number | undefined;
+    frequencyPenalty?: number | null | undefined;
     /**
-     * Provider-specific image configuration options. Keys and values vary by model/provider. See https://openrouter.ai/docs/features/multimodal/image-generation for more details.
+     * Provider-specific image configuration options. Keys and values vary by model/provider. See https://openrouter.ai/docs/guides/overview/multimodal/image-generation for more details.
      */
     imageConfig?: {
-        [k: string]: string | number;
+        [k: string]: ImageConfig;
     } | undefined;
     include?: Array<ResponseIncludesEnum> | null | undefined;
     /**
@@ -77,8 +80,8 @@ export type ResponsesRequest = {
      */
     input?: InputsUnion | undefined;
     instructions?: string | null | undefined;
-    maxOutputTokens?: number | undefined;
-    maxToolCalls?: number | undefined;
+    maxOutputTokens?: number | null | undefined;
+    maxToolCalls?: number | null | undefined;
     /**
      * Metadata key-value pairs for the request. Keys must be ≤64 characters and cannot contain brackets. Values must be ≤512 characters. Maximum 16 pairs allowed.
      */
@@ -96,7 +99,7 @@ export type ResponsesRequest = {
      * Plugins you want to enable for this request, including their settings.
      */
     plugins?: Array<AutoRouterPlugin | ContextCompressionPlugin | FileParserPlugin | ModerationPlugin | ResponseHealingPlugin | WebSearchPlugin> | undefined;
-    presencePenalty?: number | undefined;
+    presencePenalty?: number | null | undefined;
     previousResponseId?: string | null | undefined;
     prompt?: StoredPromptTemplate | null | undefined;
     promptCacheKey?: string | null | undefined;
@@ -116,7 +119,7 @@ export type ResponsesRequest = {
     sessionId?: string | undefined;
     store?: false | undefined;
     stream?: boolean | undefined;
-    temperature?: number | undefined;
+    temperature?: number | null | undefined;
     /**
      * Text output configuration including format and verbosity
      */
@@ -124,12 +127,14 @@ export type ResponsesRequest = {
     toolChoice?: OpenAIResponsesToolChoiceUnion | undefined;
     tools?: Array<ResponsesRequestToolFunction | PreviewWebSearchServerTool | Preview20250311WebSearchServerTool | LegacyWebSearchServerTool | WebSearchServerTool | FileSearchServerTool | ComputerUseServerTool | CodeInterpreterServerTool | McpServerTool | ImageGenerationServerTool | CodexLocalShellTool | ShellServerTool | ApplyPatchServerTool | CustomTool | (DatetimeServerTool & {
         type: "openrouter:datetime";
+    }) | (ImageGenerationServerToolOpenRouter & {
+        type: "openrouter:image_generation";
     }) | (ChatSearchModelsServerTool & {
         type: "openrouter:experimental__search_models";
     }) | WebSearchServerToolOpenRouter> | undefined;
     topK?: number | undefined;
-    topLogprobs?: number | undefined;
-    topP?: number | undefined;
+    topLogprobs?: number | null | undefined;
+    topP?: number | null | undefined;
     /**
      * Metadata for observability and tracing. Known keys (trace_id, trace_name, span_name, generation_name, parent_span_id) have special handling. Additional keys are passed through as custom metadata to configured broadcast destinations.
      */
@@ -141,11 +146,6 @@ export type ResponsesRequest = {
     user?: string | undefined;
 };
 /** @internal */
-export type ResponsesRequestImageConfig$Outbound = string | number;
-/** @internal */
-export declare const ResponsesRequestImageConfig$outboundSchema: z.ZodType<ResponsesRequestImageConfig$Outbound, ResponsesRequestImageConfig>;
-export declare function responsesRequestImageConfigToJSON(responsesRequestImageConfig: ResponsesRequestImageConfig): string;
-/** @internal */
 export type ResponsesRequestPlugin$Outbound = AutoRouterPlugin$Outbound | ContextCompressionPlugin$Outbound | FileParserPlugin$Outbound | ModerationPlugin$Outbound | ResponseHealingPlugin$Outbound | WebSearchPlugin$Outbound;
 /** @internal */
 export declare const ResponsesRequestPlugin$outboundSchema: z.ZodType<ResponsesRequestPlugin$Outbound, ResponsesRequestPlugin>;
@@ -168,6 +168,8 @@ export declare function responsesRequestToolFunctionToJSON(responsesRequestToolF
 /** @internal */
 export type ResponsesRequestToolUnion$Outbound = ResponsesRequestToolFunction$Outbound | PreviewWebSearchServerTool$Outbound | Preview20250311WebSearchServerTool$Outbound | LegacyWebSearchServerTool$Outbound | WebSearchServerTool$Outbound | FileSearchServerTool$Outbound | ComputerUseServerTool$Outbound | CodeInterpreterServerTool$Outbound | McpServerTool$Outbound | ImageGenerationServerTool$Outbound | CodexLocalShellTool$Outbound | ShellServerTool$Outbound | ApplyPatchServerTool$Outbound | CustomTool$Outbound | (DatetimeServerTool$Outbound & {
     type: "openrouter:datetime";
+}) | (ImageGenerationServerToolOpenRouter$Outbound & {
+    type: "openrouter:image_generation";
 }) | (ChatSearchModelsServerTool$Outbound & {
     type: "openrouter:experimental__search_models";
 }) | WebSearchServerToolOpenRouter$Outbound;
@@ -177,15 +179,15 @@ export declare function responsesRequestToolUnionToJSON(responsesRequestToolUnio
 /** @internal */
 export type ResponsesRequest$Outbound = {
     background?: boolean | null | undefined;
-    frequency_penalty?: number | undefined;
+    frequency_penalty?: number | null | undefined;
     image_config?: {
-        [k: string]: string | number;
+        [k: string]: ImageConfig$Outbound;
     } | undefined;
     include?: Array<string> | null | undefined;
     input?: InputsUnion$Outbound | undefined;
     instructions?: string | null | undefined;
-    max_output_tokens?: number | undefined;
-    max_tool_calls?: number | undefined;
+    max_output_tokens?: number | null | undefined;
+    max_tool_calls?: number | null | undefined;
     metadata?: {
         [k: string]: string;
     } | null | undefined;
@@ -194,7 +196,7 @@ export type ResponsesRequest$Outbound = {
     models?: Array<string> | undefined;
     parallel_tool_calls?: boolean | null | undefined;
     plugins?: Array<AutoRouterPlugin$Outbound | ContextCompressionPlugin$Outbound | FileParserPlugin$Outbound | ModerationPlugin$Outbound | ResponseHealingPlugin$Outbound | WebSearchPlugin$Outbound> | undefined;
-    presence_penalty?: number | undefined;
+    presence_penalty?: number | null | undefined;
     previous_response_id?: string | null | undefined;
     prompt?: StoredPromptTemplate$Outbound | null | undefined;
     prompt_cache_key?: string | null | undefined;
@@ -205,17 +207,19 @@ export type ResponsesRequest$Outbound = {
     session_id?: string | undefined;
     store: false;
     stream: boolean;
-    temperature?: number | undefined;
+    temperature?: number | null | undefined;
     text?: TextExtendedConfig$Outbound | undefined;
     tool_choice?: OpenAIResponsesToolChoiceUnion$Outbound | undefined;
     tools?: Array<ResponsesRequestToolFunction$Outbound | PreviewWebSearchServerTool$Outbound | Preview20250311WebSearchServerTool$Outbound | LegacyWebSearchServerTool$Outbound | WebSearchServerTool$Outbound | FileSearchServerTool$Outbound | ComputerUseServerTool$Outbound | CodeInterpreterServerTool$Outbound | McpServerTool$Outbound | ImageGenerationServerTool$Outbound | CodexLocalShellTool$Outbound | ShellServerTool$Outbound | ApplyPatchServerTool$Outbound | CustomTool$Outbound | (DatetimeServerTool$Outbound & {
         type: "openrouter:datetime";
+    }) | (ImageGenerationServerToolOpenRouter$Outbound & {
+        type: "openrouter:image_generation";
     }) | (ChatSearchModelsServerTool$Outbound & {
         type: "openrouter:experimental__search_models";
     }) | WebSearchServerToolOpenRouter$Outbound> | undefined;
     top_k?: number | undefined;
-    top_logprobs?: number | undefined;
-    top_p?: number | undefined;
+    top_logprobs?: number | null | undefined;
+    top_p?: number | null | undefined;
     trace?: TraceConfig$Outbound | undefined;
     truncation?: string | null | undefined;
     user?: string | undefined;

package/esm/models/responsesrequest.js

@@ -16,7 +16,9 @@ import { CustomTool$outboundSchema, } from "./customtool.js";
 import { DatetimeServerTool$outboundSchema, } from "./datetimeservertool.js";
 import { FileParserPlugin$outboundSchema, } from "./fileparserplugin.js";
 import { FileSearchServerTool$outboundSchema, } from "./filesearchservertool.js";
+import { ImageConfig$outboundSchema, } from "./imageconfig.js";
 import { ImageGenerationServerTool$outboundSchema, } from "./imagegenerationservertool.js";
+import { ImageGenerationServerToolOpenRouter$outboundSchema, } from "./imagegenerationservertoolopenrouter.js";
 import { InputsUnion$outboundSchema, } from "./inputsunion.js";
 import { LegacyWebSearchServerTool$outboundSchema, } from "./legacywebsearchservertool.js";
 import { McpServerTool$outboundSchema, } from "./mcpservertool.js";
@@ -45,11 +47,6 @@ export const ResponsesRequestServiceTier = {
     Scale: "scale",
 };
 /** @internal */
-export const ResponsesRequestImageConfig$outboundSchema = z.union([z.string(), z.number()]);
-export function responsesRequestImageConfigToJSON(responsesRequestImageConfig) {
-    return JSON.stringify(ResponsesRequestImageConfig$outboundSchema.parse(responsesRequestImageConfig));
-}
-/** @internal */
 export const ResponsesRequestPlugin$outboundSchema = z.union([
     AutoRouterPlugin$outboundSchema,
     ContextCompressionPlugin$outboundSchema,
@@ -91,6 +88,7 @@ export const ResponsesRequestToolUnion$outboundSchema = z.union([
     ApplyPatchServerTool$outboundSchema,
     CustomTool$outboundSchema,
     DatetimeServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:datetime") })),
+    ImageGenerationServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:image_generation") })),
     ChatSearchModelsServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:experimental__search_models") })),
     WebSearchServerToolOpenRouter$outboundSchema,
 ]);
@@ -100,14 +98,13 @@ export function responsesRequestToolUnionToJSON(responsesRequestToolUnion) {
 /** @internal */
 export const ResponsesRequest$outboundSchema = z.object({
     background: z.nullable(z.boolean()).optional(),
-    frequencyPenalty: z.number().optional(),
-    imageConfig: z.record(z.string(), z.union([z.string(), z.number()]))
-        .optional(),
+    frequencyPenalty: z.nullable(z.number()).optional(),
+    imageConfig: z.record(z.string(), ImageConfig$outboundSchema).optional(),
     include: z.nullable(z.array(ResponseIncludesEnum$outboundSchema)).optional(),
     input: InputsUnion$outboundSchema.optional(),
     instructions: z.nullable(z.string()).optional(),
-    maxOutputTokens: z.int().optional(),
-    maxToolCalls: z.int().optional(),
+    maxOutputTokens: z.nullable(z.int()).optional(),
+    maxToolCalls: z.nullable(z.int()).optional(),
     metadata: z.nullable(z.record(z.string(), z.string())).optional(),
     modalities: z.array(OutputModalityEnum$outboundSchema).optional(),
     model: z.string().optional(),
@@ -121,7 +118,7 @@ export const ResponsesRequest$outboundSchema = z.object({
         ResponseHealingPlugin$outboundSchema,
         WebSearchPlugin$outboundSchema,
     ])).optional(),
-    presencePenalty: z.number().optional(),
+    presencePenalty: z.nullable(z.number()).optional(),
     previousResponseId: z.nullable(z.string()).optional(),
     prompt: z.nullable(StoredPromptTemplate$outboundSchema).optional(),
     promptCacheKey: z.nullable(z.string()).optional(),
@@ -132,7 +129,7 @@ export const ResponsesRequest$outboundSchema = z.object({
     sessionId: z.string().optional(),
     store: z.literal(false).default(false),
     stream: z.boolean().default(false),
-    temperature: z.number().optional(),
+    temperature: z.nullable(z.number()).optional(),
     text: TextExtendedConfig$outboundSchema.optional(),
     toolChoice: OpenAIResponsesToolChoiceUnion$outboundSchema.optional(),
     tools: z.array(z.union([
@@ -151,12 +148,13 @@ export const ResponsesRequest$outboundSchema = z.object({
         ApplyPatchServerTool$outboundSchema,
         CustomTool$outboundSchema,
         DatetimeServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:datetime") })),
+        ImageGenerationServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:image_generation") })),
         ChatSearchModelsServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:experimental__search_models") })),
         WebSearchServerToolOpenRouter$outboundSchema,
     ])).optional(),
     topK: z.int().optional(),
-    topLogprobs: z.int().optional(),
-    topP: z.number().optional(),
+    topLogprobs: z.nullable(z.int()).optional(),
+    topP: z.nullable(z.number()).optional(),
     trace: TraceConfig$outboundSchema.optional(),
     truncation: z.nullable(OpenAIResponsesTruncation$outboundSchema).optional(),
     user: z.string().optional(),

package/esm/models/updateguardrailrequest.d.ts

@@ -28,7 +28,7 @@ export type UpdateGuardrailRequest = {
     /**
      * New spending limit in USD
      */
-    limitUsd?: number | undefined;
+    limitUsd?: number | null | undefined;
     /**
      * New name for the guardrail
      */
@@ -46,7 +46,7 @@ export type UpdateGuardrailRequest$Outbound = {
     enforce_zdr?: boolean | null | undefined;
     ignored_models?: Array<string> | null | undefined;
     ignored_providers?: Array<string> | null | undefined;
-    limit_usd?: number | undefined;
+    limit_usd?: number | null | undefined;
     name?: string | undefined;
     reset_interval?: string | null | undefined;
 };

package/esm/models/updateguardrailrequest.js

@@ -13,7 +13,7 @@ export const UpdateGuardrailRequest$outboundSchema = z.object({
     enforceZdr: z.nullable(z.boolean()).optional(),
     ignoredModels: z.nullable(z.array(z.string())).optional(),
     ignoredProviders: z.nullable(z.array(z.string())).optional(),
-    limitUsd: z.number().optional(),
+    limitUsd: z.nullable(z.number()).optional(),
     name: z.string().optional(),
     resetInterval: z.nullable(GuardrailInterval$outboundSchema).optional(),
 }).transform((v) => {

package/esm/models/usage.d.ts

@@ -8,7 +8,7 @@ export type OutputTokensDetails = {
     reasoningTokens: number;
 };
 export type CostDetails = {
-    upstreamInferenceCost?: number | undefined;
+    upstreamInferenceCost?: number | null | undefined;
     upstreamInferenceInputCost: number;
     upstreamInferenceOutputCost: number;
 };
@@ -24,7 +24,7 @@ export type Usage = {
     /**
      * Cost of the completion
      */
-    cost?: number | undefined;
+    cost?: number | null | undefined;
     costDetails?: CostDetails | undefined;
     /**
      * Whether a request was made using a Bring Your Own Key configuration

package/esm/models/usage.js

@@ -30,7 +30,7 @@ export function outputTokensDetailsFromJSON(jsonString) {
 /** @internal */
 export const CostDetails$inboundSchema = z
     .object({
-    upstream_inference_cost: z.number().optional(),
+    upstream_inference_cost: z.nullable(z.number()).optional(),
     upstream_inference_input_cost: z.number(),
     upstream_inference_output_cost: z.number(),
 }).transform((v) => {
@@ -50,7 +50,7 @@ export const Usage$inboundSchema = z.object({
     output_tokens: z.int(),
     output_tokens_details: z.lazy(() => OutputTokensDetails$inboundSchema),
     total_tokens: z.int(),
-    cost: z.number().optional(),
+    cost: z.nullable(z.number()).optional(),
     cost_details: z.lazy(() => CostDetails$inboundSchema).optional(),
     is_byok: z.boolean().optional(),
 }).transform((v) => {

package/esm/models/videogenerationusage.d.ts

@@ -8,7 +8,7 @@ export type VideoGenerationUsage = {
     /**
      * The cost of the video generation in USD.
      */
-    cost?: number | undefined;
+    cost?: number | null | undefined;
     /**
      * Whether the request was made using a Bring Your Own Key configuration.
      */

package/esm/models/videogenerationusage.js

@@ -7,7 +7,7 @@ import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
 /** @internal */
 export const VideoGenerationUsage$inboundSchema = z.object({
-    cost: z.number().optional(),
+    cost: z.nullable(z.number()).optional(),
     is_byok: z.boolean().optional(),
 }).transform((v) => {
     return remap$(v, {

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "0.12.3",
+  "version": "0.12.5",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.12.3",
+  "version": "0.12.5",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 300+ language models through a unified API.",
   "keywords": [
@@ -69,15 +69,15 @@
     "lint": "eslint --cache --max-warnings=0 src",
     "build": "tsc",
     "prepublishOnly": "npm run build",
-    "prepare": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "compile": "tsc",
     "test": "vitest --run --project unit",
     "test:e2e": "vitest --run --project e2e",
     "test:transit": "exit 0",
-    "typecheck:transit": "exit 0",
     "test:watch": "vitest --watch --project unit",
-    "typecheck": "tsc --noEmit",
-    "compile": "tsc",
-    "postinstall": "node scripts/check-types.js || true"
+    "typecheck:transit": "exit 0",
+    "postinstall": "node scripts/check-types.js || true",
+    "prepare": "npm run build"
   },
   "peerDependencies": {},
   "devDependencies": {