Skip to main content
The TypeScript SDK and docs are currently in beta. Report issues on GitHub.

Example Usage

import { ChatGenerationParams } from "@openrouter/sdk/models";

let value: ChatGenerationParams = {
  messages: [
    {
      role: "system",
      content: "<value>",
    },
  ],
};

Fields

FieldTypeRequiredDescription
providermodels.ChatGenerationParamsProvider:heavy_minus_sign:When multiple model providers are available, optionally indicate your routing preference.
pluginsmodels.ChatGenerationParamsPluginUnion[]:heavy_minus_sign:Plugins you want to enable for this request, including their settings.
routemodels.Route:heavy_minus_sign:N/A
userstring:heavy_minus_sign:N/A
sessionIdstring:heavy_minus_sign:A unique identifier for grouping related requests (e.g., a conversation or agent workflow) for observability. If provided in both the request body and the x-session-id header, the body value takes precedence. Maximum of 128 characters.
messagesmodels.Message[]:heavy_check_mark:N/A
modelstring:heavy_minus_sign:N/A
modelsstring[]:heavy_minus_sign:N/A
frequencyPenaltynumber:heavy_minus_sign:N/A
logitBiasRecord<string, *number*>:heavy_minus_sign:N/A
logprobsboolean:heavy_minus_sign:N/A
topLogprobsnumber:heavy_minus_sign:N/A
maxCompletionTokensnumber:heavy_minus_sign:N/A
maxTokensnumber:heavy_minus_sign:N/A
metadataRecord<string, *string*>:heavy_minus_sign:N/A
presencePenaltynumber:heavy_minus_sign:N/A
reasoningmodels.Reasoning:heavy_minus_sign:N/A
responseFormatmodels.ChatGenerationParamsResponseFormatUnion:heavy_minus_sign:N/A
seednumber:heavy_minus_sign:N/A
stopmodels.ChatGenerationParamsStop:heavy_minus_sign:N/A
streamboolean:heavy_minus_sign:N/A
streamOptionsmodels.ChatStreamOptions:heavy_minus_sign:N/A
temperaturenumber:heavy_minus_sign:N/A
toolChoiceany:heavy_minus_sign:N/A
toolsmodels.ToolDefinitionJson[]:heavy_minus_sign:N/A
topPnumber:heavy_minus_sign:N/A
debugmodels.Debug:heavy_minus_sign:N/A
imageConfigRecord<string, *models.ChatGenerationParamsImageConfig*>:heavy_minus_sign:N/A
modalitiesmodels.Modality[]:heavy_minus_sign:N/A