Provider - OpenRouter

OpenRouter 是统一 LLM 路由服务，通过单一 API Key 访问数百个模型，支持文本、图像生成、视频生成、TTS/STT 等多模态能力。

认证

export OPENROUTER_API_KEY=your_api_key

默认模型

model: openrouter/auto  # 自动路由到最优模型

多模态能力

图像生成

tools:
  media:
    image:
      provider: openrouter
      model: google/gemini-3.1-flash-image-preview

视频生成

tools:
  media:
    video:
      provider: openrouter
      model: google/veo-3.1-fast

TTS（文字转语音）

通过 /audio/speech 端点：

voice:
  tts:
    provider: openrouter
    model: openrouter/tts-model-name

STT（语音转文字）

通过 /audio/transcriptions 端点：

voice:
  stt:
    provider: openrouter
    model: openrouter/stt-model-name

响应缓存

OpenRouter 支持响应缓存，通过 X-OpenRouter-Cache 请求头控制：

providers:
  openrouter:
    headers:
      X-OpenRouter-Cache: "1"

特殊请求头

请求头	用途
HTTP-Referer	标识请求来源，用于统计
X-OpenRouter-Title	应用名称标识
X-OpenRouter-Categories	应用分类标识

providers:
  openrouter:
    headers:
      HTTP-Referer: https://your-app.com
      X-OpenRouter-Title: MyApp

相关链接

• providers - 所有 Provider 概览
• provider-litellm - 类似的多模型路由方案
• models - 模型配置说明