API 参数
本页提供了 OpenRouter API 支持的所有参数的完整列表。
核心参数
| 参数名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
model | 字符串 | 无 | 要使用的模型 ID。如未指定，将使用用户的默认设置。 |
messages | 对象数组 | 无 | 用于聊天补全请求的消息数组。每个消息应包含"role"和"content"字段。 |
prompt | 字符串 | 无 | 用于文本补全请求的提示文本。 |
共享参数
以下参数可用于补全和聊天补全请求：
| 参数名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
max_tokens | 整数 | 无 | 生成的最大令牌数（范围：[1, context_length)）。 |
temperature | 双精度浮点数 | 1.0 | 采样温度（范围：[0, 2]）。较高的值会产生更多样化的结果。 |
top_p | 双精度浮点数 | 1.0 | Top-p 采样值（范围：(0, 1]）。控制模型考虑的词汇概率空间。 |
top_k | 整数 | 无 | Top-k 采样值（范围：[1, Infinity)）。仅考虑概率最高的k个令牌。 |
stream | 布尔值 | false | 启用结果的流式传输。 |
seed | 整数 | 无 | 确定性输出的种子值。 |
frequency_penalty | 双精度浮点数 | 0.0 | 频率惩罚（范围：[-2, 2]）。降低已频繁使用的令牌的概率。 |
presence_penalty | 双精度浮点数 | 0.0 | 存在惩罚（范围：[-2, 2]）。降低已出现过的令牌的概率。 |
repetition_penalty | 双精度浮点数 | 1.0 | 重复惩罚（范围：(0, 2]）。降低重复词汇的概率。 |
logit_bias | 对象 | 无 | 令牌 ID 到偏置值的映射，用于调整特定令牌的概率。 |
min_p | 双精度浮点数 | 0.0 | 最小概率阈值（范围：[0, 1]）。过滤掉低于阈值的令牌。 |
top_a | 双精度浮点数 | 无 | 替代顶部采样参数（范围：[0, 1]）。 |
top_logprobs | 整数 | 无 | 返回的顶部对数概率数量。 |
OpenRouter 特有参数
以下参数是 OpenRouter 特有的：
| 参数名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
models | 字符串数组 | 无 | 用于路由覆盖的备选模型列表。 |
provider | 对象 | 无 | 用于路由的提供商偏好设置。 |
transforms | 字符串数组 | 无 | 提示转换列表（仅 OpenRouter）。 |
reasoning | 对象 | 无 | 模型推理/思考令牌的配置。 |
usage | 对象 | 无 | 是否在响应中包含使用信息。 |
上下文长度限制
每个模型都有不同的上下文长度限制，决定了输入和输出令牌的总数。您可以通过 /v1/models 端点查询模型列表，查看每个模型的 context_length 值。