@openrouter/sdk 0.12.35 → 0.13.7

package/esm/models/operations/createpresetsresponses.js

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c0a2f8b46a1c
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+import * as models from "../index.js";
+/** @internal */
+export const CreatePresetsResponsesRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    slug: z.string(),
+    responsesRequest: models.ResponsesRequest$outboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        responsesRequest: "ResponsesRequest",
+    });
+});
+export function createPresetsResponsesRequestToJSON(createPresetsResponsesRequest) {
+    return JSON.stringify(CreatePresetsResponsesRequest$outboundSchema.parse(createPresetsResponsesRequest));
+}
+//# sourceMappingURL=createpresetsresponses.js.map

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

@@ -23,14 +23,31 @@ export type CreateRerankGlobals = {
      */
     appCategories?: string | undefined;
 };
+/**
+ * A structured document with optional text and/or image content. At least one of `text` or `image` must be provided.
+ */
+export type DocumentRequest = {
+    /**
+     * An image associated with the document, as a remote URL (http/https) or a base64-encoded data URI (data:image/...).
+     */
+    image?: string | undefined;
+    /**
+     * The document text
+     */
+    text?: string | undefined;
+};
+/**
+ * A document to rerank. Either a plain string, or a structured object with optional `text` and/or `image`.
+ */
+export type Document = string | DocumentRequest;
 /**
  * Rerank request input
  */
 export type CreateRerankRequestBody = {
     /**
-     * The list of documents to rerank
+     * The list of documents to rerank. Documents may be plain strings, or structured objects with `text` and/or `image` for multimodal models.
      */
-    documents: Array<string>;
+    documents: Array<string | DocumentRequest>;
     /**
      * The rerank model to use
      */
@@ -68,22 +85,26 @@ export type CreateRerankRequest = {
     requestBody: CreateRerankRequestBody;
 };
 /**
- * The document object containing the original text
+ * The document object echoing the original input (text and/or image)
  */
-export type Document = {
+export type DocumentResponse = {
+    /**
+     * The image (URL or data URI) from the original document
+     */
+    image?: string | undefined;
     /**
      * The document text
      */
-    text: string;
+    text?: string | undefined;
 };
 /**
  * A single rerank result
  */
 export type Result = {
     /**
-     * The document object containing the original text
+     * The document object echoing the original input (text and/or image)
      */
-    document: Document;
+    document: DocumentResponse;
     /**
      * Index of the document in the original input list
      */
@@ -137,8 +158,21 @@ export type CreateRerankResponseBody = {
 };
 export type CreateRerankResponse = CreateRerankResponseBody | string;
 /** @internal */
+export type DocumentRequest$Outbound = {
+    image?: string | undefined;
+    text?: string | undefined;
+};
+/** @internal */
+export declare const DocumentRequest$outboundSchema: z.ZodType<DocumentRequest$Outbound, DocumentRequest>;
+export declare function documentRequestToJSON(documentRequest: DocumentRequest): string;
+/** @internal */
+export type Document$Outbound = string | DocumentRequest$Outbound;
+/** @internal */
+export declare const Document$outboundSchema: z.ZodType<Document$Outbound, Document>;
+export declare function documentToJSON(document: Document): string;
+/** @internal */
 export type CreateRerankRequestBody$Outbound = {
-    documents: Array<string>;
+    documents: Array<string | DocumentRequest$Outbound>;
     model: string;
     provider?: models.ProviderPreferences$Outbound | null | undefined;
     query: string;
@@ -158,8 +192,8 @@ export type CreateRerankRequest$Outbound = {
 export declare const CreateRerankRequest$outboundSchema: z.ZodType<CreateRerankRequest$Outbound, CreateRerankRequest>;
 export declare function createRerankRequestToJSON(createRerankRequest: CreateRerankRequest): string;
 /** @internal */
-export declare const Document$inboundSchema: z.ZodType<Document, unknown>;
-export declare function documentFromJSON(jsonString: string): SafeParseResult<Document, SDKValidationError>;
+export declare const DocumentResponse$inboundSchema: z.ZodType<DocumentResponse, unknown>;
+export declare function documentResponseFromJSON(jsonString: string): SafeParseResult<DocumentResponse, SDKValidationError>;
 /** @internal */
 export declare const Result$inboundSchema: z.ZodType<Result, unknown>;
 export declare function resultFromJSON(jsonString: string): SafeParseResult<Result, SDKValidationError>;

package/esm/models/operations/creatererank.js

@@ -7,8 +7,22 @@ import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
 import * as models from "../index.js";
 /** @internal */
+export const DocumentRequest$outboundSchema = z.object({
+    image: z.string().optional(),
+    text: z.string().optional(),
+});
+export function documentRequestToJSON(documentRequest) {
+    return JSON.stringify(DocumentRequest$outboundSchema.parse(documentRequest));
+}
+/** @internal */
+export const Document$outboundSchema = z
+    .union([z.string(), z.lazy(() => DocumentRequest$outboundSchema)]);
+export function documentToJSON(document) {
+    return JSON.stringify(Document$outboundSchema.parse(document));
+}
+/** @internal */
 export const CreateRerankRequestBody$outboundSchema = z.object({
-    documents: z.array(z.string()),
+    documents: z.array(z.union([z.string(), z.lazy(() => DocumentRequest$outboundSchema)])),
     model: z.string(),
     provider: z.nullable(models.ProviderPreferences$outboundSchema).optional(),
     query: z.string(),
@@ -37,15 +51,16 @@ export function createRerankRequestToJSON(createRerankRequest) {
     return JSON.stringify(CreateRerankRequest$outboundSchema.parse(createRerankRequest));
 }
 /** @internal */
-export const Document$inboundSchema = z.object({
-    text: z.string(),
+export const DocumentResponse$inboundSchema = z.object({
+    image: z.string().optional(),
+    text: z.string().optional(),
 });
-export function documentFromJSON(jsonString) {
-    return safeParse(jsonString, (x) => Document$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'Document' from JSON`);
+export function documentResponseFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => DocumentResponse$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'DocumentResponse' from JSON`);
 }
 /** @internal */
 export const Result$inboundSchema = z.object({
-    document: z.lazy(() => Document$inboundSchema),
+    document: z.lazy(() => DocumentResponse$inboundSchema),
     index: z.int(),
     relevance_score: z.number(),
 }).transform((v) => {

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

@@ -45,9 +45,9 @@ export type CreateResponsesRequest = {
      */
     appCategories?: string | undefined;
     /**
-     * Opt-in to surface routing metadata on the response under `openrouter_metadata`. Defaults to `disabled`.
+     * Opt-in to surface routing metadata on the response under `openrouter_metadata`. Defaults to `disabled`. The legacy header `X-OpenRouter-Experimental-Metadata` is also accepted for backward compatibility.
      */
-    xOpenRouterExperimentalMetadata?: models.MetadataLevel | undefined;
+    xOpenRouterMetadata?: models.MetadataLevel | undefined;
     responsesRequest: models.ResponsesRequest;
 };
 export type CreateResponsesResponse = models.OpenResponsesResult | EventStream<models.StreamEvents>;
@@ -56,7 +56,7 @@ export type CreateResponsesRequest$Outbound = {
     "HTTP-Referer"?: string | undefined;
     appTitle?: string | undefined;
     appCategories?: string | undefined;
-    "X-OpenRouter-Experimental-Metadata"?: string | undefined;
+    "X-OpenRouter-Metadata"?: string | undefined;
     ResponsesRequest: models.ResponsesRequest$Outbound;
 };
 /** @internal */

package/esm/models/operations/createresponses.js

@@ -12,13 +12,12 @@ export const CreateResponsesRequest$outboundSchema = z.object({
     httpReferer: z.string().optional(),
     appTitle: z.string().optional(),
     appCategories: z.string().optional(),
-    xOpenRouterExperimentalMetadata: models.MetadataLevel$outboundSchema
-        .optional(),
+    xOpenRouterMetadata: models.MetadataLevel$outboundSchema.optional(),
     responsesRequest: models.ResponsesRequest$outboundSchema,
 }).transform((v) => {
     return remap$(v, {
         httpReferer: "HTTP-Referer",
-        xOpenRouterExperimentalMetadata: "X-OpenRouter-Experimental-Metadata",
+        xOpenRouterMetadata: "X-OpenRouter-Metadata",
         responsesRequest: "ResponsesRequest",
     });
 });

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

@@ -0,0 +1,58 @@
+import * as z from "zod/v4";
+export type DeleteBYOKKeyGlobals = {
+    /**
+     * 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 DeleteBYOKKeyRequest = {
+    /**
+     * 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 DeleteBYOKKeyRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    id: string;
+};
+/** @internal */
+export declare const DeleteBYOKKeyRequest$outboundSchema: z.ZodType<DeleteBYOKKeyRequest$Outbound, DeleteBYOKKeyRequest>;
+export declare function deleteBYOKKeyRequestToJSON(deleteBYOKKeyRequest: DeleteBYOKKeyRequest): string;
+//# sourceMappingURL=deletebyokkey.d.ts.map

package/esm/models/operations/deletebyokkey.js

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 948bcb0fbfc1
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const DeleteBYOKKeyRequest$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 deleteBYOKKeyRequestToJSON(deleteBYOKKeyRequest) {
+    return JSON.stringify(DeleteBYOKKeyRequest$outboundSchema.parse(deleteBYOKKeyRequest));
+}
+//# sourceMappingURL=deletebyokkey.js.map

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

@@ -0,0 +1,60 @@
+import * as z from "zod/v4";
+export type DeleteFileGlobals = {
+    /**
+     * 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 DeleteFileRequest = {
+    /**
+     * 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 DeleteFileRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    file_id: string;
+    workspace_id?: string | undefined;
+};
+/** @internal */
+export declare const DeleteFileRequest$outboundSchema: z.ZodType<DeleteFileRequest$Outbound, DeleteFileRequest>;
+export declare function deleteFileRequestToJSON(deleteFileRequest: DeleteFileRequest): string;
+//# sourceMappingURL=deletefile.d.ts.map

package/esm/models/operations/deletefile.js

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4b741f4bc99e
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const DeleteFileRequest$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 deleteFileRequestToJSON(deleteFileRequest) {
+    return JSON.stringify(DeleteFileRequest$outboundSchema.parse(deleteFileRequest));
+}
+//# sourceMappingURL=deletefile.js.map

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

@@ -0,0 +1,58 @@
+import * as z from "zod/v4";
+export type DeleteObservabilityDestinationGlobals = {
+    /**
+     * 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 DeleteObservabilityDestinationRequest = {
+    /**
+     * 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 destination ID (UUID).
+     */
+    id: string;
+};
+/** @internal */
+export type DeleteObservabilityDestinationRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    id: string;
+};
+/** @internal */
+export declare const DeleteObservabilityDestinationRequest$outboundSchema: z.ZodType<DeleteObservabilityDestinationRequest$Outbound, DeleteObservabilityDestinationRequest>;
+export declare function deleteObservabilityDestinationRequestToJSON(deleteObservabilityDestinationRequest: DeleteObservabilityDestinationRequest): string;
+//# sourceMappingURL=deleteobservabilitydestination.d.ts.map

package/esm/models/operations/deleteobservabilitydestination.js

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a6ab575f608d
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const DeleteObservabilityDestinationRequest$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 deleteObservabilityDestinationRequestToJSON(deleteObservabilityDestinationRequest) {
+    return JSON.stringify(DeleteObservabilityDestinationRequest$outboundSchema.parse(deleteObservabilityDestinationRequest));
+}
+//# sourceMappingURL=deleteobservabilitydestination.js.map

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

@@ -0,0 +1,60 @@
+import * as z from "zod/v4";
+export type DownloadFileContentGlobals = {
+    /**
+     * 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 DownloadFileContentRequest = {
+    /**
+     * 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 DownloadFileContentRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    file_id: string;
+    workspace_id?: string | undefined;
+};
+/** @internal */
+export declare const DownloadFileContentRequest$outboundSchema: z.ZodType<DownloadFileContentRequest$Outbound, DownloadFileContentRequest>;
+export declare function downloadFileContentRequestToJSON(downloadFileContentRequest: DownloadFileContentRequest): string;
+//# sourceMappingURL=downloadfilecontent.d.ts.map

package/esm/models/operations/downloadfilecontent.js

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1c7f08d2fedf
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const DownloadFileContentRequest$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 downloadFileContentRequestToJSON(downloadFileContentRequest) {
+    return JSON.stringify(DownloadFileContentRequest$outboundSchema.parse(downloadFileContentRequest));
+}
+//# sourceMappingURL=downloadfilecontent.js.map