chore(i18n): refresh zh-CN translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
e2b52c5740
commit
c634943daf
@ -1,21 +1,21 @@
|
||||
---
|
||||
read_when:
|
||||
- 你希望用一个 API 密钥调用多个大语言模型
|
||||
- 你想用一个 API 密钥访问多个大语言模型
|
||||
- 你想在 OpenClaw 中通过 OpenRouter 运行模型
|
||||
- 你想使用 OpenRouter 进行图像生成
|
||||
- 你想使用 OpenRouter 进行视频生成
|
||||
summary: 使用 OpenRouter 的统一 API 在 OpenClaw 中访问多种模型
|
||||
summary: 在 OpenClaw 中使用 OpenRouter 的统一 API 访问多种模型
|
||||
title: OpenRouter
|
||||
x-i18n:
|
||||
generated_at: "2026-05-04T00:07:07Z"
|
||||
generated_at: "2026-05-04T00:13:57Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: c262c43c2b8835f85f8e556b081bad8504a8c9b3b876f46e6decbab561e9be0e
|
||||
source_hash: f6b7299408aa0de7530e2248c7fa5dae8c09095e2d20a0e9d12a64cab83966fc
|
||||
source_path: providers/openrouter.md
|
||||
workflow: 16
|
||||
---
|
||||
|
||||
OpenRouter 提供一个 **统一 API**，可通过单个端点和 API key 将请求路由到多个模型。它兼容 OpenAI，因此大多数 OpenAI SDK 只需切换 base URL 即可使用。
|
||||
OpenRouter 提供一个**统一 API**，可通过单个端点和 API key 将请求路由到许多模型。它兼容 OpenAI，因此大多数 OpenAI SDK 只需切换基础 URL 即可使用。
|
||||
|
||||
## 入门指南
|
||||
|
||||
@ -29,7 +29,7 @@ OpenRouter 提供一个 **统一 API**，可通过单个端点和 API key 将请
|
||||
```
|
||||
</Step>
|
||||
<Step title="（可选）切换到特定模型">
|
||||
新手引导默认使用 `openrouter/auto`。稍后可选择一个具体模型：
|
||||
新手引导默认使用 `openrouter/auto`。之后可以选择一个具体模型：
|
||||
|
||||
```bash
|
||||
openclaw models set openrouter/<provider>/<model>
|
||||
@ -54,7 +54,7 @@ OpenRouter 提供一个 **统一 API**，可通过单个端点和 API key 将请
|
||||
## 模型引用
|
||||
|
||||
<Note>
|
||||
模型引用遵循 `openrouter/<provider>/<model>` 模式。有关可用提供商和模型的完整列表，请参见 [/concepts/model-providers](/zh-CN/concepts/model-providers)。
|
||||
模型引用遵循 `openrouter/<provider>/<model>` 模式。可用提供商和模型的完整列表见 [/concepts/model-providers](/zh-CN/concepts/model-providers)。
|
||||
</Note>
|
||||
|
||||
内置回退示例：
|
||||
@ -66,7 +66,7 @@ OpenRouter 提供一个 **统一 API**，可通过单个端点和 API key 将请
|
||||
|
||||
## 图像生成
|
||||
|
||||
OpenRouter 也可以为 `image_generate` 工具提供支持。在 `agents.defaults.imageGenerationModel` 下使用 OpenRouter 图像模型：
|
||||
OpenRouter 也可以支持 `image_generate` 工具。在 `agents.defaults.imageGenerationModel` 下使用 OpenRouter 图像模型：
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -82,11 +82,11 @@ OpenRouter 也可以为 `image_generate` 工具提供支持。在 `agents.defaul
|
||||
}
|
||||
```
|
||||
|
||||
OpenClaw 会使用 `modalities: ["image", "text"]` 将图像请求发送到 OpenRouter 的聊天补全图像 API。Gemini 图像模型会通过 OpenRouter 的 `image_config` 接收受支持的 `aspectRatio` 和 `resolution` 提示。对于较慢的 OpenRouter 图像模型，请使用 `agents.defaults.imageGenerationModel.timeoutMs`；`image_generate` 工具逐次调用的 `timeoutMs` 参数仍会优先。
|
||||
OpenClaw 会使用 `modalities: ["image", "text"]` 将图像请求发送到 OpenRouter 的聊天补全图像 API。Gemini 图像模型会通过 OpenRouter 的 `image_config` 接收受支持的 `aspectRatio` 和 `resolution` 提示。对于较慢的 OpenRouter 图像模型，请使用 `agents.defaults.imageGenerationModel.timeoutMs`；`image_generate` 工具每次调用的 `timeoutMs` 参数仍会优先。
|
||||
|
||||
## 视频生成
|
||||
|
||||
OpenRouter 也可以通过其异步 `/videos` API 为 `video_generate` 工具提供支持。在 `agents.defaults.videoGenerationModel` 下使用 OpenRouter 视频模型：
|
||||
OpenRouter 也可以通过其异步 `/videos` API 支持 `video_generate` 工具。在 `agents.defaults.videoGenerationModel` 下使用 OpenRouter 视频模型：
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -101,7 +101,7 @@ OpenRouter 也可以通过其异步 `/videos` API 为 `video_generate` 工具提
|
||||
}
|
||||
```
|
||||
|
||||
OpenClaw 会向 OpenRouter 提交文本转视频和图像转视频作业，轮询返回的 `polling_url`，并从 OpenRouter 的 `unsigned_urls` 或文档化的作业内容端点下载完成的视频。默认情况下，参考图像会作为首帧/末帧图像发送；带有 `reference_image` 标记的图像会作为 OpenRouter 输入引用发送。内置的 `google/veo-3.1-fast` 默认值声明了当前支持的 4/6/8 秒时长、`720P`/`1080P` 分辨率，以及 `16:9`/`9:16` 宽高比。OpenRouter 未注册视频转视频，因为上游视频生成 API 当前接受文本和图像引用。
|
||||
OpenClaw 会将文生视频和图生视频任务提交到 OpenRouter，轮询返回的 `polling_url`，并从 OpenRouter 的 `unsigned_urls` 或已记录的任务内容端点下载完成的视频。默认情况下，参考图像会作为首帧/末帧图像发送；标记为 `reference_image` 的图像会作为 OpenRouter 输入参考发送。内置的 `google/veo-3.1-fast` 默认值声明当前支持 4/6/8 秒时长、`720P`/`1080P` 分辨率，以及 `16:9`/`9:16` 宽高比。OpenRouter 未注册视频到视频，因为上游视频生成 API 目前接受文本和图像参考。
|
||||
|
||||
## 文本转语音
|
||||
|
||||
@ -125,29 +125,29 @@ OpenRouter 也可以通过其兼容 OpenAI 的 `/audio/speech` 端点用作 TTS
|
||||
}
|
||||
```
|
||||
|
||||
如果省略 `messages.tts.providers.openrouter.apiKey`，TTS 会复用 `models.providers.openrouter.apiKey`，然后使用 `OPENROUTER_API_KEY`。
|
||||
如果省略 `messages.tts.providers.openrouter.apiKey`，TTS 会复用 `models.providers.openrouter.apiKey`，然后再使用 `OPENROUTER_API_KEY`。
|
||||
|
||||
## 认证和标头
|
||||
## 身份验证和请求头
|
||||
|
||||
OpenRouter 在底层使用带有你的 API key 的 Bearer token。
|
||||
OpenRouter 底层使用带有你的 API key 的 Bearer 令牌。
|
||||
|
||||
在真实的 OpenRouter 请求（`https://openrouter.ai/api/v1`）中，OpenClaw 还会添加 OpenRouter 文档化的应用归因标头：
|
||||
在真实的 OpenRouter 请求（`https://openrouter.ai/api/v1`）中，OpenClaw 还会添加 OpenRouter 文档中的应用归因请求头：
|
||||
|
||||
| 标头 | 值 |
|
||||
| ------------------------- | --------------------- |
|
||||
| `HTTP-Referer` | `https://openclaw.ai` |
|
||||
| `X-OpenRouter-Title` | `OpenClaw` |
|
||||
| `X-OpenRouter-Categories` | `cli-agent` |
|
||||
| 请求头 | 值 |
|
||||
| ------------------------- | ------------------------------------------------------------------------------------------------------ |
|
||||
| `HTTP-Referer` | `https://openclaw.ai` |
|
||||
| `X-OpenRouter-Title` | `OpenClaw` |
|
||||
| `X-OpenRouter-Categories` | `cli-agent,cloud-agent,programming-app,creative-writing,writing-assistant,general-chat,personal-agent` |
|
||||
|
||||
<Warning>
|
||||
如果你将 OpenRouter provider 重新指向其他代理或 base URL，OpenClaw **不会**注入这些 OpenRouter 专用标头或 Anthropic 缓存标记。
|
||||
如果你将 OpenRouter provider 指向其他代理或基础 URL，OpenClaw **不会**注入这些 OpenRouter 专用请求头或 Anthropic 缓存标记。
|
||||
</Warning>
|
||||
|
||||
## 高级配置
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="响应缓存">
|
||||
OpenRouter 响应缓存需要选择启用。使用模型参数按 OpenRouter 模型启用：
|
||||
OpenRouter 响应缓存是选择启用的。使用模型参数为每个 OpenRouter 模型启用：
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -166,30 +166,30 @@ OpenRouter 在底层使用带有你的 API key 的 Bearer token。
|
||||
}
|
||||
```
|
||||
|
||||
OpenClaw 会发送 `X-OpenRouter-Cache: true`，并在配置时发送 `X-OpenRouter-Cache-TTL`。`responseCacheClear: true` 会强制刷新当前请求并存储替换响应。也接受 snake_case 别名（`response_cache`、`response_cache_ttl_seconds` 和 `response_cache_clear`）。
|
||||
OpenClaw 会发送 `X-OpenRouter-Cache: true`，并在配置后发送 `X-OpenRouter-Cache-TTL`。`responseCacheClear: true` 会强制刷新当前请求并存储替换响应。也接受 snake_case 别名（`response_cache`、`response_cache_ttl_seconds` 和 `response_cache_clear`）。
|
||||
|
||||
这与提供商提示缓存以及 OpenRouter 的 Anthropic `cache_control` 标记相互独立。它只会应用于经过验证的 `openrouter.ai` 路由，而不是自定义代理 base URL。
|
||||
这与提供商提示词缓存以及 OpenRouter 的 Anthropic `cache_control` 标记相互独立。它只会应用于已验证的 `openrouter.ai` 路由，而不会应用于自定义代理基础 URL。
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Anthropic 缓存标记">
|
||||
在经过验证的 OpenRouter 路由上，Anthropic 模型引用会保留 OpenClaw 用于在系统/开发者提示块上更好复用提示缓存的 OpenRouter 专用 Anthropic `cache_control` 标记。
|
||||
在已验证的 OpenRouter 路由上，Anthropic 模型引用会保留 OpenRouter 专用的 Anthropic `cache_control` 标记，OpenClaw 使用这些标记在系统/开发者提示词块上更好地复用提示词缓存。
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Anthropic reasoning 预填充">
|
||||
在经过验证的 OpenRouter 路由上，启用 reasoning 的 Anthropic 模型引用会在请求到达 OpenRouter 前丢弃末尾的 assistant 预填充轮次，以符合 Anthropic 要求 reasoning 对话以用户轮次结束的规则。
|
||||
<Accordion title="Anthropic 推理预填充">
|
||||
在已验证的 OpenRouter 路由上，启用推理的 Anthropic 模型引用会在请求到达 OpenRouter 之前删除末尾的 assistant 预填充轮次，以匹配 Anthropic 要求推理对话以用户轮次结束的规则。
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Thinking / reasoning 注入">
|
||||
在受支持的非 `auto` 路由上，OpenClaw 会将选定的 thinking 级别映射到 OpenRouter 代理 reasoning 载荷。不支持的模型提示和 `openrouter/auto` 会跳过该 reasoning 注入。Hunter Alpha 也会对过期配置的模型引用跳过代理 reasoning，因为 OpenRouter 可能会在该已退役路由的 reasoning 字段中返回最终答案文本。
|
||||
<Accordion title="思考 / 推理注入">
|
||||
在受支持的非 `auto` 路由上，OpenClaw 会将所选思考级别映射到 OpenRouter 代理推理载荷。不受支持的模型提示和 `openrouter/auto` 会跳过该推理注入。Hunter Alpha 也会对过时配置的模型引用跳过代理推理，因为 OpenRouter 可能会在该已退役路由的推理字段中返回最终答案文本。
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="DeepSeek V4 reasoning 重放">
|
||||
在经过验证的 OpenRouter 路由上，`openrouter/deepseek/deepseek-v4-flash` 和 `openrouter/deepseek/deepseek-v4-pro` 会在重放的 assistant 轮次中填充缺失的 `reasoning_content`，使 thinking/工具对话保持 DeepSeek V4 所需的后续形状。
|
||||
<Accordion title="DeepSeek V4 推理重放">
|
||||
在已验证的 OpenRouter 路由上，`openrouter/deepseek/deepseek-v4-flash` 和 `openrouter/deepseek/deepseek-v4-pro` 会为重放的 assistant 轮次填补缺失的 `reasoning_content`，以便思考/工具对话保持 DeepSeek V4 要求的后续形态。
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="仅限 OpenAI 的请求整形">
|
||||
OpenRouter 仍然走代理风格的 OpenAI 兼容路径，因此不会转发原生仅限 OpenAI 的请求整形，例如 `serviceTier`、Responses `store`、OpenAI reasoning 兼容载荷，以及提示缓存提示。
|
||||
<Accordion title="仅限 OpenAI 的请求塑形">
|
||||
OpenRouter 仍通过代理风格的 OpenAI 兼容路径运行，因此不会转发原生仅限 OpenAI 的请求塑形，例如 `serviceTier`、Responses `store`、OpenAI 推理兼容载荷和提示词缓存提示。
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Gemini 支持的路由">
|
||||
@ -197,7 +197,7 @@ OpenRouter 在底层使用带有你的 API key 的 Bearer token。
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="提供商路由元数据">
|
||||
如果你在模型参数下传递 OpenRouter 提供商路由，OpenClaw 会在共享流包装器运行之前将其作为 OpenRouter 路由元数据转发。
|
||||
如果你在模型参数下传入 OpenRouter 提供商路由，OpenClaw 会在共享流包装器运行之前将其作为 OpenRouter 路由元数据转发。
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user