illegalCreed

中文

English

中文

English

Appearance

参考 ​

基于 OpenRouter 2026 编写。完整 API 见 openrouter.ai/docs。

API Endpoints ​

Endpoint用途
POST /api/v1/chat/completions聊天（OpenAI 兼容）
POST /api/v1/completions旧式 completions
GET /api/v1/models模型列表
GET /api/v1/auth/keyAPI key 信息
GET /api/v1/credits余额查询
GET /api/v1/activity活动记录
POST /api/v1/credits/charge充值

chat/completions 兼容性 ​

OpenRouter 遵循 OpenAI Chat Completions API schema，完全兼容 OpenAI SDK 的所有方法（包括 streaming / tool_use / multi-modal / response_format 等）。

python
client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.getenv("OPENROUTER_API_KEY"),
)
# 之后所有调用与官方 OpenAI 完全相同

OpenRouter 特定参数（extra_body） ​

python
extra_body={
    "provider": {
        "order": ["openai", "anthropic", "azure"],
        "allow_fallbacks": True,
        "sort": "throughput",      # throughput / latency / price
        "require_parameters": True,
        "data_collection": "deny", # allow / deny（覆盖账号设置）
        "ignore": ["xai"],          # 排除某些 provider
    },
    "transforms": ["middle-out"],   # context 压缩策略
    "models": [                      # 多 model fallback（OR 自动选）
        "openai/gpt-5",
        "anthropic/claude-sonnet-4.6",
    ],
    "route": "fallback",            # fallback / auto
}

模型 ID 格式 ​

<vendor>/<model-name>[:variant]

主流 vendor 与模型 ​

Anthropic ​

anthropic/claude-opus-4.7
anthropic/claude-opus-4.7:1m         # 1M 上下文
anthropic/claude-sonnet-4.6
anthropic/claude-haiku-4.5
anthropic/claude-3.5-sonnet           # 旧版

OpenAI ​

openai/gpt-5
openai/gpt-5-mini
openai/gpt-5-nano
openai/o3
openai/o4-mini
openai/gpt-4o
openai/gpt-4o-mini

Google ​

google/gemini-2.5-pro
google/gemini-2.5-flash
google/gemini-2.5-flash-lite
google/gemini-2.5-flash-image

xAI ​

xai/grok-2
xai/grok-2-vision
xai/grok-4

Meta Llama ​

meta-llama/llama-3.3-70b-instruct
meta-llama/llama-3.3-70b-instruct:free
meta-llama/llama-3.1-405b-instruct
meta-llama/llama-3.1-8b-instruct:free

Mistral ​

mistralai/mistral-large
mistralai/mistral-medium
mistralai/mixtral-8x22b-instruct

DeepSeek ​

deepseek/deepseek-r1
deepseek/deepseek-v3
deepseek/deepseek-chat
deepseek/deepseek-r1:free

阿里 Qwen ​

qwen/qwen-2.5-72b-instruct
qwen/qwen-2.5-coder-32b-instruct
qwen/qwen-vl-max
qwen/qwen-2.5-7b-instruct:free

智谱 GLM ​

zhipu/glm-4-plus
zhipu/glm-4-air
zhipu/glm-4v

Cohere ​

cohere/command-r-plus
cohere/command-r-08-2024

Auto Routing ​

openrouter/auto                       # 让 OR 自动选最优

:variant 后缀 ​

后缀含义
:free免费 tier（rate limit 严格 + 允许训练）
:1m1M 上下文版本（Claude / GPT-5 等）
:nitro极速 provider 优先（部分模型）
:betabeta 版本
:online自动接 web search（部分模型）

Provider 完整列表 ​

主要 provider：

Provider提供模型区域
openaiOpenAI 直连美国
anthropicAnthropic 直连美国
google-vertexGoogle Vertex AI多 region
google-ai-studioGoogle AI Studio全球
azureAzure OpenAI多 region
fireworksFireworks AI（开源模型托管）美国
togetherTogether AI美国
groqGroq（极速推理）美国
cerebrasCerebras（极速）美国
deepinfraDeepInfra美国
nebiusNebius AI欧洲
mistralMistral 直连欧洲

完整列表 + 实时状态：openrouter.ai/providers

价格速查（2026，含中间费） ​

ModelInput $/MOutput $/M
anthropic/claude-opus-4.7$16.50$82.50
anthropic/claude-sonnet-4.6$3.30$16.50
anthropic/claude-haiku-4.5$0.88$4.40
openai/gpt-5$5.50$27.50
openai/gpt-5-mini$0.55$2.75
openai/gpt-5-nano$0.11$0.44
openai/o3$16.50$66
google/gemini-2.5-pro$1.38$5.50
google/gemini-2.5-flash$0.36$1.44
google/gemini-2.5-flash-lite$0.09$0.36
deepseek/deepseek-r1$0.30$1.20
qwen/qwen-2.5-72b-instruct$0.40$0.60
meta-llama/llama-3.3-70b$0.27$0.40
xai/grok-4$5$15

实时价格：openrouter.ai/models

Rate Limits ​

按 API key + model 限速。免费 tier 严格：

模型类型默认 RPM默认 RPD
:free 模型20200
付费模型由 provider 决定-

充值 $10+ 后 free model RPD 上升到 1000。

Models endpoint 字段 ​

json
{
  "data": [
    {
      "id": "anthropic/claude-sonnet-4.6",
      "canonical_slug": "anthropic/claude-sonnet-4.6",
      "name": "Claude Sonnet 4.6",
      "created": 1234567890,
      "description": "...",
      "context_length": 200000,
      "architecture": {
        "modality": "text+image->text",
        "tokenizer": "Claude",
        "instruct_type": null
      },
      "pricing": {
        "prompt": "0.0000033",
        "completion": "0.0000165",
        "image": "0.0048",
        "request": "0"
      },
      "top_provider": {
        "context_length": 200000,
        "max_completion_tokens": 8192,
        "is_moderated": false
      },
      "per_request_limits": null
    }
  ]
}

Headers ​

Request Headers ​

Header用途
Authorization: Bearer <key>API key
HTTP-Referer来源 URL（Activity 显示）
X-Title应用名（Activity 显示）
OpenRouter-ClientSDK 标识（自动加）

Response Headers ​

Header用途
OpenRouter-Provider实际用的 provider
OpenRouter-Model实际用的 model
OpenRouter-Cost本次费用（USD）
OpenRouter-Provider-Costprovider 原始费用
X-OpenRouter-Latency-Ms实际延迟
python
response = client.chat.completions.with_raw_response.create(...)
print(response.http_response.headers.get("OpenRouter-Provider"))
print(response.http_response.headers.get("OpenRouter-Cost"))

错误码 ​

HTTP类型含义
400bad_request参数错
401unauthorizedAPI key 错
402payment_requiredcredit 不足
403forbiddenmodel 无权限（某 provider 拒）
404not_foundmodel ID 不存在
408timeoutprovider 超时
429rate_limit超 RPM / RPD
500internal_errorOR 内部错
502bad_gatewayprovider 返错
503service_unavailable所有 provider 不可用
json
{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "metadata": {
      "provider": "openai",
      "raw": "..."
    }
  }
}

CLI 工具 ​

OpenRouter 没官方 CLI，社区有：

bash
# openrouter-cli（社区）
npm i -g openrouter-cli
openrouter chat anthropic/claude-sonnet-4.6 "你好"

或用 aichat：

yaml
# ~/.config/aichat/config.yaml
clients:
  - type: openai-compatible
    name: openrouter
    api_base: https://openrouter.ai/api/v1
    api_key: sk-or-v1-xxx
    models:
      - name: claude
        model: anthropic/claude-sonnet-4.6
      - name: gpt5
        model: openai/gpt-5
bash
aichat -m openrouter:claude "你好"

数据政策详解 ​

设置默认影响
Account-wide logging✓ 开OR 保留 30 天用于 Activity（关闭后 0 保留）
Provider training opt-in各家独立部分上游可能用你数据训练
:free model允许训练不可关
Anthropic / OpenAI 付费不训练直接遵循各家政策
Vertex / Bedrock不训练合规级别
python
# 单次请求覆盖
extra_body={
    "provider": {
        "data_collection": "deny",   # 强制禁止收集
    }
}

资源链接 ​