@openrouter/sdk 0.12.35 → 0.13.7

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

@@ -0,0 +1,83 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../../types/enums.js";
+export type GetBenchmarksDesignArenaGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+/**
+ * Arena to query. Defaults to `models`.
+ */
+export declare const Arena: {
+    readonly Models: "models";
+    readonly Builders: "builders";
+    readonly Agents: "agents";
+};
+/**
+ * Arena to query. Defaults to `models`.
+ */
+export type Arena = OpenEnum<typeof Arena>;
+export type GetBenchmarksDesignArenaRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    /**
+     * Arena to query. Defaults to `models`.
+     */
+    arena?: Arena | undefined;
+    /**
+     * Category within the arena (e.g. `codecategories`, `uicomponent`, `gamedev`, `3d`, `dataviz`, `image`, `video`, `svg`). When omitted, returns all categories.
+     */
+    category?: string | undefined;
+    /**
+     * Max results to return: per category when no category filter is applied (1–100, default 50).
+     */
+    maxResults?: number | undefined;
+};
+/** @internal */
+export declare const Arena$outboundSchema: z.ZodType<string, Arena>;
+/** @internal */
+export type GetBenchmarksDesignArenaRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    arena: string;
+    category?: string | undefined;
+    max_results: number;
+};
+/** @internal */
+export declare const GetBenchmarksDesignArenaRequest$outboundSchema: z.ZodType<GetBenchmarksDesignArenaRequest$Outbound, GetBenchmarksDesignArenaRequest>;
+export declare function getBenchmarksDesignArenaRequestToJSON(getBenchmarksDesignArenaRequest: GetBenchmarksDesignArenaRequest): string;
+//# sourceMappingURL=getbenchmarksdesignarena.d.ts.map

package/esm/models/operations/getbenchmarksdesignarena.js

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 86e27de57b33
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+import * as openEnums from "../../types/enums.js";
+/**
+ * Arena to query. Defaults to `models`.
+ */
+export const Arena = {
+    Models: "models",
+    Builders: "builders",
+    Agents: "agents",
+};
+/** @internal */
+export const Arena$outboundSchema = openEnums
+    .outboundSchema(Arena);
+/** @internal */
+export const GetBenchmarksDesignArenaRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    arena: Arena$outboundSchema.default("models"),
+    category: z.string().optional(),
+    maxResults: z.int().default(50),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        maxResults: "max_results",
+    });
+});
+export function getBenchmarksDesignArenaRequestToJSON(getBenchmarksDesignArenaRequest) {
+    return JSON.stringify(GetBenchmarksDesignArenaRequest$outboundSchema.parse(getBenchmarksDesignArenaRequest));
+}
+//# sourceMappingURL=getbenchmarksdesignarena.js.map

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

@@ -0,0 +1,58 @@
+import * as z from "zod/v4";
+export type GetBYOKKeyGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+export type GetBYOKKeyRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    /**
+     * The BYOK credential ID (UUID).
+     */
+    id: string;
+};
+/** @internal */
+export type GetBYOKKeyRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    id: string;
+};
+/** @internal */
+export declare const GetBYOKKeyRequest$outboundSchema: z.ZodType<GetBYOKKeyRequest$Outbound, GetBYOKKeyRequest>;
+export declare function getBYOKKeyRequestToJSON(getBYOKKeyRequest: GetBYOKKeyRequest): string;
+//# sourceMappingURL=getbyokkey.d.ts.map

package/esm/models/operations/getbyokkey.js

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 883c19bd90fb
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const GetBYOKKeyRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    id: z.string(),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+    });
+});
+export function getBYOKKeyRequestToJSON(getBYOKKeyRequest) {
+    return JSON.stringify(GetBYOKKeyRequest$outboundSchema.parse(getBYOKKeyRequest));
+}
+//# sourceMappingURL=getbyokkey.js.map

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

@@ -0,0 +1,60 @@
+import * as z from "zod/v4";
+export type GetFileMetadataGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+export type GetFileMetadataRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    fileId: string;
+    /**
+     * Workspace to scope the request to. Defaults to the caller’s default workspace.
+     */
+    workspaceId?: string | undefined;
+};
+/** @internal */
+export type GetFileMetadataRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    file_id: string;
+    workspace_id?: string | undefined;
+};
+/** @internal */
+export declare const GetFileMetadataRequest$outboundSchema: z.ZodType<GetFileMetadataRequest$Outbound, GetFileMetadataRequest>;
+export declare function getFileMetadataRequestToJSON(getFileMetadataRequest: GetFileMetadataRequest): string;
+//# sourceMappingURL=getfilemetadata.d.ts.map

package/esm/models/operations/getfilemetadata.js

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: accbd0757579
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const GetFileMetadataRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    fileId: z.string(),
+    workspaceId: z.string().optional(),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        fileId: "file_id",
+        workspaceId: "workspace_id",
+    });
+});
+export function getFileMetadataRequestToJSON(getFileMetadataRequest) {
+    return JSON.stringify(GetFileMetadataRequest$outboundSchema.parse(getFileMetadataRequest));
+}
+//# sourceMappingURL=getfilemetadata.js.map

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

@@ -0,0 +1,63 @@
+import * as z from "zod/v4";
+export type GetModelGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+export type GetModelRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    /**
+     * The author/organization of the model
+     */
+    author: string;
+    /**
+     * The model slug, optionally including a variant suffix (e.g. gpt-4 or gpt-4:free)
+     */
+    slug: string;
+};
+/** @internal */
+export type GetModelRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    author: string;
+    slug: string;
+};
+/** @internal */
+export declare const GetModelRequest$outboundSchema: z.ZodType<GetModelRequest$Outbound, GetModelRequest>;
+export declare function getModelRequestToJSON(getModelRequest: GetModelRequest): string;
+//# sourceMappingURL=getmodel.d.ts.map

package/esm/models/operations/getmodel.js

@@ -0,0 +1,22 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2ffcb8988513
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const GetModelRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    author: z.string(),
+    slug: z.string(),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+    });
+});
+export function getModelRequestToJSON(getModelRequest) {
+    return JSON.stringify(GetModelRequest$outboundSchema.parse(getModelRequest));
+}
+//# sourceMappingURL=getmodel.js.map

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

@@ -1,5 +1,5 @@
 import * as z from "zod/v4";
-import { OpenEnum } from "../../types/enums.js";
+import { ClosedEnum, OpenEnum } from "../../types/enums.js";
 export type GetModelsGlobals = {
     /**
      * The app identifier should be your app's URL and is used as the primary identifier for rankings.
@@ -24,7 +24,7 @@ export type GetModelsGlobals = {
 /**
  * Filter models by use case category
  */
-export declare const Category: {
+export declare const GetModelsCategory: {
     readonly Programming: "programming";
     readonly Roleplay: "roleplay";
     readonly Marketing: "marketing";
@@ -41,7 +41,55 @@ export declare const Category: {
 /**
  * Filter models by use case category
  */
-export type Category = OpenEnum<typeof Category>;
+export type GetModelsCategory = OpenEnum<typeof GetModelsCategory>;
+/**
+ * Sort the returned models server-side. Prefer this over fetching the full list and sorting client-side. Options: pricing-low-to-high, pricing-high-to-low (average prompt/completion price), context-high-to-low (context length), throughput-high-to-low, latency-low-to-high (recent median performance), most-popular, top-weekly (tokens processed in the last week), newest (creation date). When omitted, the existing default ordering is preserved.
+ */
+export declare const GetModelsSort: {
+    readonly MostPopular: "most-popular";
+    readonly Newest: "newest";
+    readonly TopWeekly: "top-weekly";
+    readonly PricingLowToHigh: "pricing-low-to-high";
+    readonly PricingHighToLow: "pricing-high-to-low";
+    readonly ContextHighToLow: "context-high-to-low";
+    readonly ThroughputHighToLow: "throughput-high-to-low";
+    readonly LatencyLowToHigh: "latency-low-to-high";
+};
+/**
+ * Sort the returned models server-side. Prefer this over fetching the full list and sorting client-side. Options: pricing-low-to-high, pricing-high-to-low (average prompt/completion price), context-high-to-low (context length), throughput-high-to-low, latency-low-to-high (recent median performance), most-popular, top-weekly (tokens processed in the last week), newest (creation date). When omitted, the existing default ordering is preserved.
+ */
+export type GetModelsSort = OpenEnum<typeof GetModelsSort>;
+/**
+ * Filter by distillation capability. "true" returns only distillable models, "false" excludes them.
+ */
+export declare const Distillable: {
+    readonly True: "true";
+    readonly False: "false";
+};
+/**
+ * Filter by distillation capability. "true" returns only distillable models, "false" excludes them.
+ */
+export type Distillable = OpenEnum<typeof Distillable>;
+/**
+ * When set to "true", return only models with zero data retention endpoints.
+ */
+export declare const Zdr: {
+    readonly True: "true";
+};
+/**
+ * When set to "true", return only models with zero data retention endpoints.
+ */
+export type Zdr = ClosedEnum<typeof Zdr>;
+/**
+ * Filter to models with endpoints in the given data region. Currently only "eu" is supported.
+ */
+export declare const Region: {
+    readonly Eu: "eu";
+};
+/**
+ * Filter to models with endpoints in the given data region. Currently only "eu" is supported.
+ */
+export type Region = ClosedEnum<typeof Region>;
 export type GetModelsRequest = {
     /**
      * The app identifier should be your app's URL and is used as the primary identifier for rankings.
@@ -65,7 +113,7 @@ export type GetModelsRequest = {
     /**
      * Filter models by use case category
      */
-    category?: Category | undefined;
+    category?: GetModelsCategory | undefined;
     /**
      * Filter models by supported parameter (comma-separated)
      */
@@ -74,9 +122,65 @@ export type GetModelsRequest = {
      * Filter models by output modality. Accepts a comma-separated list of modalities (text, image, audio, embeddings) or "all" to include all models. Defaults to "text".
      */
     outputModalities?: string | undefined;
+    /**
+     * Sort the returned models server-side. Prefer this over fetching the full list and sorting client-side. Options: pricing-low-to-high, pricing-high-to-low (average prompt/completion price), context-high-to-low (context length), throughput-high-to-low, latency-low-to-high (recent median performance), most-popular, top-weekly (tokens processed in the last week), newest (creation date). When omitted, the existing default ordering is preserved.
+     */
+    sort?: GetModelsSort | undefined;
+    /**
+     * Free-text search by model name or slug.
+     */
+    q?: string | undefined;
+    /**
+     * Filter models by input modality. Comma-separated list of: text, image, audio, file.
+     */
+    inputModalities?: string | undefined;
+    /**
+     * Minimum context length (tokens). Models with smaller context are excluded.
+     */
+    context?: number | undefined;
+    /**
+     * Minimum prompt price in $/M tokens.
+     */
+    minPrice?: number | null | undefined;
+    /**
+     * Maximum prompt price in $/M tokens.
+     */
+    maxPrice?: number | null | undefined;
+    /**
+     * Filter models by architecture/model family (e.g. GPT, Claude, Gemini, Llama).
+     */
+    arch?: string | undefined;
+    /**
+     * Filter models by the organization that created the model. Comma-separated list of author slugs.
+     */
+    modelAuthors?: string | undefined;
+    /**
+     * Filter models by hosting provider. Comma-separated list of provider names.
+     */
+    providers?: string | undefined;
+    /**
+     * Filter by distillation capability. "true" returns only distillable models, "false" excludes them.
+     */
+    distillable?: Distillable | undefined;
+    /**
+     * When set to "true", return only models with zero data retention endpoints.
+     */
+    zdr?: Zdr | undefined;
+    /**
+     * Filter to models with endpoints in the given data region. Currently only "eu" is supported.
+     */
+    region?: Region | undefined;
 };
 /** @internal */
-export declare const Category$outboundSchema: z.ZodType<string, Category>;
+export declare const GetModelsCategory$outboundSchema: z.ZodType<string, GetModelsCategory>;
+/** @internal */
+export declare const GetModelsSort$outboundSchema: z.ZodType<string, GetModelsSort>;
+/** @internal */
+export declare const Distillable$outboundSchema: z.ZodType<string, Distillable>;
+/** @internal */
+export declare const Zdr$outboundSchema: z.ZodEnum<typeof Zdr>;
+/** @internal */
+export declare const Region$outboundSchema: z.ZodEnum<typeof Region>;
 /** @internal */
 export type GetModelsRequest$Outbound = {
     "HTTP-Referer"?: string | undefined;
@@ -85,6 +189,18 @@ export type GetModelsRequest$Outbound = {
     category?: string | undefined;
     supported_parameters?: string | undefined;
     output_modalities?: string | undefined;
+    sort?: string | undefined;
+    q?: string | undefined;
+    input_modalities?: string | undefined;
+    context?: number | undefined;
+    min_price?: number | null | undefined;
+    max_price?: number | null | undefined;
+    arch?: string | undefined;
+    model_authors?: string | undefined;
+    providers?: string | undefined;
+    distillable?: string | undefined;
+    zdr?: string | undefined;
+    region?: string | undefined;
 };
 /** @internal */
 export declare const GetModelsRequest$outboundSchema: z.ZodType<GetModelsRequest$Outbound, GetModelsRequest>;

package/esm/models/operations/getmodels.js

@@ -8,7 +8,7 @@ import * as openEnums from "../../types/enums.js";
 /**
  * Filter models by use case category
  */
-export const Category = {
+export const GetModelsCategory = {
     Programming: "programming",
     Roleplay: "roleplay",
     Marketing: "marketing",
@@ -22,22 +22,77 @@ export const Category = {
     Trivia: "trivia",
     Academia: "academia",
 };
+/**
+ * Sort the returned models server-side. Prefer this over fetching the full list and sorting client-side. Options: pricing-low-to-high, pricing-high-to-low (average prompt/completion price), context-high-to-low (context length), throughput-high-to-low, latency-low-to-high (recent median performance), most-popular, top-weekly (tokens processed in the last week), newest (creation date). When omitted, the existing default ordering is preserved.
+ */
+export const GetModelsSort = {
+    MostPopular: "most-popular",
+    Newest: "newest",
+    TopWeekly: "top-weekly",
+    PricingLowToHigh: "pricing-low-to-high",
+    PricingHighToLow: "pricing-high-to-low",
+    ContextHighToLow: "context-high-to-low",
+    ThroughputHighToLow: "throughput-high-to-low",
+    LatencyLowToHigh: "latency-low-to-high",
+};
+/**
+ * Filter by distillation capability. "true" returns only distillable models, "false" excludes them.
+ */
+export const Distillable = {
+    True: "true",
+    False: "false",
+};
+/**
+ * When set to "true", return only models with zero data retention endpoints.
+ */
+export const Zdr = {
+    True: "true",
+};
+/**
+ * Filter to models with endpoints in the given data region. Currently only "eu" is supported.
+ */
+export const Region = {
+    Eu: "eu",
+};
+/** @internal */
+export const GetModelsCategory$outboundSchema = openEnums.outboundSchema(GetModelsCategory);
+/** @internal */
+export const GetModelsSort$outboundSchema = openEnums.outboundSchema(GetModelsSort);
+/** @internal */
+export const Distillable$outboundSchema = openEnums.outboundSchema(Distillable);
+/** @internal */
+export const Zdr$outboundSchema = z.enum(Zdr);
 /** @internal */
-export const Category$outboundSchema = openEnums
-    .outboundSchema(Category);
+export const Region$outboundSchema = z.enum(Region);
 /** @internal */
 export const GetModelsRequest$outboundSchema = z.object({
     httpReferer: z.string().optional(),
     appTitle: z.string().optional(),
     appCategories: z.string().optional(),
-    category: Category$outboundSchema.optional(),
+    category: GetModelsCategory$outboundSchema.optional(),
     supportedParameters: z.string().optional(),
     outputModalities: z.string().optional(),
+    sort: GetModelsSort$outboundSchema.optional(),
+    q: z.string().optional(),
+    inputModalities: z.string().optional(),
+    context: z.int().optional(),
+    minPrice: z.nullable(z.number()).optional(),
+    maxPrice: z.nullable(z.number()).optional(),
+    arch: z.string().optional(),
+    modelAuthors: z.string().optional(),
+    providers: z.string().optional(),
+    distillable: Distillable$outboundSchema.optional(),
+    zdr: Zdr$outboundSchema.optional(),
+    region: Region$outboundSchema.optional(),
 }).transform((v) => {
     return remap$(v, {
         httpReferer: "HTTP-Referer",
         supportedParameters: "supported_parameters",
         outputModalities: "output_modalities",
+        inputModalities: "input_modalities",
+        minPrice: "min_price",
+        maxPrice: "max_price",
+        modelAuthors: "model_authors",
     });
 });
 export function getModelsRequestToJSON(getModelsRequest) {