@openrouter/sdk 1.2.125 → 1.2.127

package/esm/lib/config.d.ts

@@ -50,8 +50,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.0.0";
-    readonly sdkVersion: "1.2.125";
+    readonly sdkVersion: "1.2.127";
     readonly genVersion: "2.914.0";
-    readonly userAgent: "speakeasy-sdk/typescript 1.2.125 2.914.0 1.0.0 @openrouter/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 1.2.127 2.914.0 1.0.0 @openrouter/sdk";
 };
 //# sourceMappingURL=config.d.ts.map

package/esm/lib/config.js

@@ -29,8 +29,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "1.2.125",
+    sdkVersion: "1.2.127",
     genVersion: "2.914.0",
-    userAgent: "speakeasy-sdk/typescript 1.2.125 2.914.0 1.0.0 @openrouter/sdk",
+    userAgent: "speakeasy-sdk/typescript 1.2.127 2.914.0 1.0.0 @openrouter/sdk",
 };
 //# sourceMappingURL=config.js.map

package/esm/models/freemodeldailyrequests.d.ts

@@ -0,0 +1,24 @@
+import * as z from "zod/v4";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+/**
+ * Free-model (`:free` variant) daily request quota for the account that owns the key. Reports the same counter and tier limit that free-model enforcement reads for accounts subject to the free-model limits; the counter resets at UTC midnight. Accounts and endpoints exempt from free-model limits, and BYOK requests, are not gated by it, so `remaining` is the tier policy rather than an enforced ceiling for them.
+ */
+export type FreeModelDailyRequests = {
+    /**
+     * Free-model requests the account may make per UTC day; the ceiling depends on total credits purchased and is independent of `is_free_tier`
+     */
+    limit: number;
+    /**
+     * Free-model requests left in the current UTC day
+     */
+    remaining: number;
+    /**
+     * Free-model requests recorded for the account so far in the current UTC day
+     */
+    used: number;
+};
+/** @internal */
+export declare const FreeModelDailyRequests$inboundSchema: z.ZodType<FreeModelDailyRequests, unknown>;
+export declare function freeModelDailyRequestsFromJSON(jsonString: string): SafeParseResult<FreeModelDailyRequests, SDKValidationError>;
+//# sourceMappingURL=freemodeldailyrequests.d.ts.map

package/esm/models/freemodeldailyrequests.js

@@ -0,0 +1,16 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6ed229ff1382
+ */
+import * as z from "zod/v4";
+import { safeParse } from "../lib/schemas.js";
+/** @internal */
+export const FreeModelDailyRequests$inboundSchema = z.object({
+    limit: z.int(),
+    remaining: z.int(),
+    used: z.int(),
+});
+export function freeModelDailyRequestsFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => FreeModelDailyRequests$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'FreeModelDailyRequests' from JSON`);
+}
+//# sourceMappingURL=freemodeldailyrequests.js.map

package/esm/models/imagegenerationrequest.d.ts

@@ -2,6 +2,7 @@ import * as z from "zod/v4";
 import { OpenEnum } from "../types/enums.js";
 import { ContentPartImage, ContentPartImage$Outbound } from "./contentpartimage.js";
 import { ImageGenerationProviderPreferences, ImageGenerationProviderPreferences$Outbound } from "./imagegenerationproviderpreferences.js";
+import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
 /**
  * Normalized aspect ratio of the generated image. Providers clamp to their supported subset.
  */
@@ -148,6 +149,10 @@ export type ImageGenerationRequest = {
      * If true, partial images are streamed as SSE events as they become available. Only supported by providers with native streaming (currently OpenAI). Non-streaming providers ignore this flag and return a buffered response.
      */
     stream?: boolean | 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.
+     */
+    trace?: TraceConfig | undefined;
     /**
      * A stable identifier for your end-users. Used to help detect and prevent abuse. Never sent to providers verbatim: for providers whose data policy requires user IDs, it is folded into a hashed, per-account upstream user identifier.
      */
@@ -179,6 +184,7 @@ export type ImageGenerationRequest$Outbound = {
     seed?: number | undefined;
     size?: string | undefined;
     stream?: boolean | undefined;
+    trace?: TraceConfig$Outbound | undefined;
     user?: string | undefined;
 };
 /** @internal */

package/esm/models/imagegenerationrequest.js

@@ -7,6 +7,7 @@ import { remap as remap$ } from "../lib/primitives.js";
 import * as openEnums from "../types/enums.js";
 import { ContentPartImage$outboundSchema, } from "./contentpartimage.js";
 import { ImageGenerationProviderPreferences$outboundSchema, } from "./imagegenerationproviderpreferences.js";
+import { TraceConfig$outboundSchema, } from "./traceconfig.js";
 /**
  * Normalized aspect ratio of the generated image. Providers clamp to their supported subset.
  */
@@ -99,6 +100,7 @@ export const ImageGenerationRequest$outboundSchema = z.object({
     seed: z.int().optional(),
     size: z.string().optional(),
     stream: z.boolean().optional(),
+    trace: TraceConfig$outboundSchema.optional(),
     user: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {

package/esm/models/index.d.ts

@@ -228,6 +228,7 @@ export * from "./formatjsonschemaconfig.js";
 export * from "./formats.js";
 export * from "./formattextconfig.js";
 export * from "./frameimage.js";
+export * from "./freemodeldailyrequests.js";
 export * from "./functioncallargsdeltaevent.js";
 export * from "./functioncallargsdoneevent.js";
 export * from "./functioncallitem.js";

package/esm/models/index.js

@@ -232,6 +232,7 @@ export * from "./formatjsonschemaconfig.js";
 export * from "./formats.js";
 export * from "./formattextconfig.js";
 export * from "./frameimage.js";
+export * from "./freemodeldailyrequests.js";
 export * from "./functioncallargsdeltaevent.js";
 export * from "./functioncallargsdoneevent.js";
 export * from "./functioncallitem.js";

package/esm/models/operations/createembeddings.d.ts

@@ -79,6 +79,10 @@ export type CreateEmbeddingsRequestBody = {
      */
     model: string;
     provider?: models.ProviderPreferences | 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.
+     */
+    trace?: models.TraceConfig | undefined;
     /**
      * A unique identifier for the end-user
      */
@@ -259,6 +263,7 @@ export type CreateEmbeddingsRequestBody$Outbound = {
     input_type?: string | undefined;
     model: string;
     provider?: models.ProviderPreferences$Outbound | null | undefined;
+    trace?: models.TraceConfig$Outbound | undefined;
     user?: string | undefined;
 };
 /** @internal */

package/esm/models/operations/createembeddings.js

@@ -100,6 +100,7 @@ export const CreateEmbeddingsRequestBody$outboundSchema = z.object({
     inputType: z.string().optional(),
     model: z.string(),
     provider: z.nullable(models.ProviderPreferences$outboundSchema).optional(),
+    trace: models.TraceConfig$outboundSchema.optional(),
     user: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {

package/esm/models/operations/creatererank.d.ts

@@ -61,6 +61,10 @@ export type CreateRerankRequestBody = {
      * Number of most relevant documents to return
      */
     topN?: number | 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.
+     */
+    trace?: models.TraceConfig | undefined;
     /**
      * A unique identifier representing your end-user. Forwarded to Broadcast and private logging as the end-user id; never sent to the provider.
      */
@@ -181,6 +185,7 @@ export type CreateRerankRequestBody$Outbound = {
     provider?: models.ProviderPreferences$Outbound | null | undefined;
     query: string;
     top_n?: number | undefined;
+    trace?: models.TraceConfig$Outbound | undefined;
     user?: string | undefined;
 };
 /** @internal */

package/esm/models/operations/creatererank.js

@@ -27,6 +27,7 @@ export const CreateRerankRequestBody$outboundSchema = z.object({
     provider: z.nullable(models.ProviderPreferences$outboundSchema).optional(),
     query: z.string(),
     topN: z.int().optional(),
+    trace: models.TraceConfig$outboundSchema.optional(),
     user: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {

package/esm/models/operations/getcurrentkey.d.ts

@@ -1,6 +1,7 @@
 import * as z from "zod/v4";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import * as models from "../index.js";
 export type GetCurrentKeyGlobals = {
     /**
      * The app identifier should be your app's URL and is used as the primary identifier for rankings.
@@ -90,6 +91,10 @@ export type GetCurrentKeyData = {
      * ISO 8601 UTC timestamp when the API key expires, or null if no expiration
      */
     expiresAt?: Date | null | undefined;
+    /**
+     * Free-model (`:free` variant) daily request quota for the account that owns the key. Reports the same counter and tier limit that free-model enforcement reads for accounts subject to the free-model limits; the counter resets at UTC midnight. Accounts and endpoints exempt from free-model limits, and BYOK requests, are not gated by it, so `remaining` is the tier policy rather than an enforced ceiling for them.
+     */
+    freeModelDailyRequests: models.FreeModelDailyRequests;
     /**
      * Whether to include external BYOK usage in the credit limit
      */

package/esm/models/operations/getcurrentkey.js

@@ -5,6 +5,7 @@
 import * as z from "zod/v4";
 import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
+import * as models from "../index.js";
 /** @internal */
 export const GetCurrentKeyRequest$outboundSchema = z.object({
     httpReferer: z.string().optional(),
@@ -35,6 +36,7 @@ export const GetCurrentKeyData$inboundSchema = z.object({
     byok_usage_weekly: z.number(),
     creator_user_id: z.nullable(z.string()),
     expires_at: z.nullable(z.iso.datetime({ offset: true }).transform(v => new Date(v))).optional(),
+    free_model_daily_requests: models.FreeModelDailyRequests$inboundSchema,
     include_byok_in_limit: z.boolean(),
     is_free_tier: z.boolean(),
     is_management_key: z.boolean(),
@@ -56,6 +58,7 @@ export const GetCurrentKeyData$inboundSchema = z.object({
         "byok_usage_weekly": "byokUsageWeekly",
         "creator_user_id": "creatorUserId",
         "expires_at": "expiresAt",
+        "free_model_daily_requests": "freeModelDailyRequests",
         "include_byok_in_limit": "includeByokInLimit",
         "is_free_tier": "isFreeTier",
         "is_management_key": "isManagementKey",

package/esm/models/speechrequest.d.ts

@@ -2,6 +2,7 @@ import * as z from "zod/v4";
 import { OpenEnum } from "../types/enums.js";
 import { ProviderOptions, ProviderOptions$Outbound } from "./provideroptions.js";
 import { SpeechInputReference, SpeechInputReference$Outbound } from "./speechinputreference.js";
+import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
 /**
  * Provider-specific passthrough configuration
  */
@@ -50,6 +51,10 @@ export type SpeechRequest = {
      * Playback speed multiplier. Only used by models that support it (e.g. OpenAI TTS). Ignored by other providers.
      */
     speed?: number | 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.
+     */
+    trace?: TraceConfig | undefined;
     /**
      * A unique identifier representing your end-user. Forwarded to Broadcast and private logging as the end-user id; never sent to the provider.
      */
@@ -76,6 +81,7 @@ export type SpeechRequest$Outbound = {
     provider?: SpeechRequestProvider$Outbound | undefined;
     response_format: string;
     speed?: number | undefined;
+    trace?: TraceConfig$Outbound | undefined;
     user?: string | undefined;
     voice?: string | undefined;
 };

package/esm/models/speechrequest.js

@@ -7,6 +7,7 @@ import { remap as remap$ } from "../lib/primitives.js";
 import * as openEnums from "../types/enums.js";
 import { ProviderOptions$outboundSchema, } from "./provideroptions.js";
 import { SpeechInputReference$outboundSchema, } from "./speechinputreference.js";
+import { TraceConfig$outboundSchema, } from "./traceconfig.js";
 /**
  * Audio output format
  */
@@ -31,6 +32,7 @@ export const SpeechRequest$outboundSchema = z.object({
     provider: z.lazy(() => SpeechRequestProvider$outboundSchema).optional(),
     responseFormat: SpeechRequestResponseFormat$outboundSchema.default("pcm"),
     speed: z.number().optional(),
+    trace: TraceConfig$outboundSchema.optional(),
     user: z.string().optional(),
     voice: z.string().optional(),
 }).transform((v) => {

package/esm/models/sttrequest.d.ts

@@ -3,6 +3,7 @@ import { OpenEnum } from "../types/enums.js";
 import { ProviderOptions, ProviderOptions$Outbound } from "./provideroptions.js";
 import { STTInputAudio, STTInputAudio$Outbound } from "./sttinputaudio.js";
 import { STTTimestampGranularity } from "./stttimestampgranularity.js";
+import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
 /**
  * Provider-specific passthrough configuration
  */
@@ -55,6 +56,10 @@ export type STTRequest = {
      * Timestamp detail levels to include when response_format is "verbose_json". "segment" returns segment-level timestamps; "word" additionally returns word-level timestamps in the words array. Ignored unless response_format is "verbose_json".
      */
     timestampGranularities?: Array<STTTimestampGranularity> | 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.
+     */
+    trace?: TraceConfig | undefined;
     /**
      * A unique identifier representing your end-user. Forwarded to Broadcast and private logging as the end-user id; never sent to the provider.
      */
@@ -78,6 +83,7 @@ export type STTRequest$Outbound = {
     response_format?: string | undefined;
     temperature?: number | undefined;
     timestamp_granularities?: Array<string> | undefined;
+    trace?: TraceConfig$Outbound | undefined;
     user?: string | undefined;
 };
 /** @internal */

package/esm/models/sttrequest.js

@@ -8,6 +8,7 @@ import * as openEnums from "../types/enums.js";
 import { ProviderOptions$outboundSchema, } from "./provideroptions.js";
 import { STTInputAudio$outboundSchema, } from "./sttinputaudio.js";
 import { STTTimestampGranularity$outboundSchema, } from "./stttimestampgranularity.js";
+import { TraceConfig$outboundSchema, } from "./traceconfig.js";
 /**
  * Output format. "json" (default) returns { text, usage }. "verbose_json" additionally returns task, language, duration, and segment-level timestamps; only supported by OpenAI-compatible providers.
  */
@@ -34,6 +35,7 @@ export const STTRequest$outboundSchema = z.object({
     temperature: z.number().optional(),
     timestampGranularities: z.array(STTTimestampGranularity$outboundSchema)
         .optional(),
+    trace: TraceConfig$outboundSchema.optional(),
     user: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {

package/esm/models/videogenerationrequest.d.ts

@@ -2,6 +2,7 @@ import * as z from "zod/v4";
 import { OpenEnum } from "../types/enums.js";
 import { FrameImage, FrameImage$Outbound } from "./frameimage.js";
 import { InputReference, InputReference$Outbound } from "./inputreference.js";
+import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
 /**
  * Aspect ratio of the generated video
  */
@@ -520,6 +521,10 @@ export type VideoGenerationRequest = {
      * Exact pixel dimensions of the generated video in "WIDTHxHEIGHT" format (e.g. "1280x720"). Interchangeable with resolution + aspect_ratio.
      */
     size?: string | 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.
+     */
+    trace?: TraceConfig | undefined;
     /**
      * Upscale factor for video upscaling models only. This parameter is not supported by video generation models.
      */
@@ -984,6 +989,7 @@ export type VideoGenerationRequest$Outbound = {
     resolution?: string | undefined;
     seed?: number | undefined;
     size?: string | undefined;
+    trace?: TraceConfig$Outbound | undefined;
     upscale_factor?: number | undefined;
     user?: string | undefined;
 };

package/esm/models/videogenerationrequest.js

@@ -7,6 +7,7 @@ import { remap as remap$ } from "../lib/primitives.js";
 import * as openEnums from "../types/enums.js";
 import { FrameImage$outboundSchema, } from "./frameimage.js";
 import { InputReference$outboundSchema, } from "./inputreference.js";
+import { TraceConfig$outboundSchema, } from "./traceconfig.js";
 /**
  * Aspect ratio of the generated video
  */
@@ -241,6 +242,7 @@ export const VideoGenerationRequest$outboundSchema = z.object({
     resolution: VideoGenerationRequestResolution$outboundSchema.optional(),
     seed: z.int().optional(),
     size: z.string().optional(),
+    trace: TraceConfig$outboundSchema.optional(),
     upscaleFactor: z.number().optional(),
     user: z.string().optional(),
 }).transform((v) => {

package/jsr.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "1.2.125",
+  "version": "1.2.127",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 400+ language models through a unified API.",
   "keywords": [
@@ -76,11 +76,11 @@
     "compile": "tsc",
     "postinstall": "node scripts/check-types.js || true",
     "prepare": "npm run build",
+    "test": "vitest --run --project unit",
+    "test:watch": "vitest --watch --project unit",
     "test:e2e": "vitest --run --project e2e",
     "test:transit": "exit 0",
     "typecheck": "tsc --noEmit",
-    "test": "vitest --run --project unit",
-    "test:watch": "vitest --watch --project unit",
     "typecheck:transit": "exit 0"
   },
   "peerDependencies": {},