@openrouter/sdk 0.12.79 → 0.13.13

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,57 @@ 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), intelligence-high-to-low (Artificial Analysis intelligence index), design-arena-elo-high-to-low (best Design Arena ELO across arenas). Models without a score for the chosen benchmark are placed last. 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";
+    readonly IntelligenceHighToLow: "intelligence-high-to-low";
+    readonly DesignArenaEloHighToLow: "design-arena-elo-high-to-low";
+};
+/**
+ * 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), intelligence-high-to-low (Artificial Analysis intelligence index), design-arena-elo-high-to-low (best Design Arena ELO across arenas). Models without a score for the chosen benchmark are placed last. 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 +115,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 +124,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), intelligence-high-to-low (Artificial Analysis intelligence index), design-arena-elo-high-to-low (best Design Arena ELO across arenas). Models without a score for the chosen benchmark are placed last. 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 +191,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,79 @@ 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), intelligence-high-to-low (Artificial Analysis intelligence index), design-arena-elo-high-to-low (best Design Arena ELO across arenas). Models without a score for the chosen benchmark are placed last. 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",
+    IntelligenceHighToLow: "intelligence-high-to-low",
+    DesignArenaEloHighToLow: "design-arena-elo-high-to-low",
+};
+/**
+ * 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) {

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

@@ -0,0 +1,58 @@
+import * as z from "zod/v4";
+export type GetPresetGlobals = {
+    /**
+     * 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 GetPresetRequest = {
+    /**
+     * 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;
+    /**
+     * URL-safe slug identifying the preset.
+     */
+    slug: string;
+};
+/** @internal */
+export type GetPresetRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    slug: string;
+};
+/** @internal */
+export declare const GetPresetRequest$outboundSchema: z.ZodType<GetPresetRequest$Outbound, GetPresetRequest>;
+export declare function getPresetRequestToJSON(getPresetRequest: GetPresetRequest): string;
+//# sourceMappingURL=getpreset.d.ts.map

package/esm/models/operations/getpreset.js

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

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

@@ -0,0 +1,63 @@
+import * as z from "zod/v4";
+export type GetPresetVersionGlobals = {
+    /**
+     * 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 GetPresetVersionRequest = {
+    /**
+     * 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;
+    /**
+     * URL-safe slug identifying the preset.
+     */
+    slug: string;
+    /**
+     * Version number of the preset.
+     */
+    version: string;
+};
+/** @internal */
+export type GetPresetVersionRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    slug: string;
+    version: string;
+};
+/** @internal */
+export declare const GetPresetVersionRequest$outboundSchema: z.ZodType<GetPresetVersionRequest$Outbound, GetPresetVersionRequest>;
+export declare function getPresetVersionRequestToJSON(getPresetVersionRequest: GetPresetVersionRequest): string;
+//# sourceMappingURL=getpresetversion.d.ts.map

package/esm/models/operations/getpresetversion.js

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

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

@@ -0,0 +1,71 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../../types/enums.js";
+export type GetTaskClassificationsGlobals = {
+    /**
+     * 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;
+};
+/**
+ * Trailing time window for the classification data. Currently only `7d` (trailing 7 days) is supported.
+ */
+export declare const Window: {
+    readonly Sevend: "7d";
+};
+/**
+ * Trailing time window for the classification data. Currently only `7d` (trailing 7 days) is supported.
+ */
+export type Window = ClosedEnum<typeof Window>;
+export type GetTaskClassificationsRequest = {
+    /**
+     * 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;
+    /**
+     * Trailing time window for the classification data. Currently only `7d` (trailing 7 days) is supported.
+     */
+    window?: Window | undefined;
+};
+/** @internal */
+export declare const Window$outboundSchema: z.ZodEnum<typeof Window>;
+/** @internal */
+export type GetTaskClassificationsRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    window: string;
+};
+/** @internal */
+export declare const GetTaskClassificationsRequest$outboundSchema: z.ZodType<GetTaskClassificationsRequest$Outbound, GetTaskClassificationsRequest>;
+export declare function getTaskClassificationsRequestToJSON(getTaskClassificationsRequest: GetTaskClassificationsRequest): string;
+//# sourceMappingURL=gettaskclassifications.d.ts.map

package/esm/models/operations/gettaskclassifications.js

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8482753ddd33
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/**
+ * Trailing time window for the classification data. Currently only `7d` (trailing 7 days) is supported.
+ */
+export const Window = {
+    Sevend: "7d",
+};
+/** @internal */
+export const Window$outboundSchema = z.enum(Window);
+/** @internal */
+export const GetTaskClassificationsRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    window: Window$outboundSchema.default("7d"),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+    });
+});
+export function getTaskClassificationsRequestToJSON(getTaskClassificationsRequest) {
+    return JSON.stringify(GetTaskClassificationsRequest$outboundSchema.parse(getTaskClassificationsRequest));
+}
+//# sourceMappingURL=gettaskclassifications.js.map