OpenRouter开源的AI大模型路由工具，统一API调用

简介

‌OpenRouter是一个开源的路由工具‌，它可以绕过限制调用GPT、Claude等国外模型。以下是对它的详细介绍：

一、主要功能

OpenRouter专注于将用户请求智能路由到不同的AI模型，并提供统一的访问接口。它就像一个“路由器”，能够根据预设规则或用户自定义策略，将用户输入的请求自动分配至最合适的AI模型。这大大简化了与AI模型交互的过程，降低了开发者的集成复杂度。

二、技术特点

‌多模型支持‌：OpenRouter集成了来自多个提供商的模型，包括知名的闭源模型（如OpenAI的GPT-4、Anthropic的Claude等）和开源模型（如LLaMA、Mistral等）。目前支持数十种模型，未来计划扩展到数百种。
‌统一API‌：OpenRouter的API与OpenAI的聊天API高度兼容，用户只需更换API密钥和基础URL，就能轻松切换模型，无需修改代码。
‌价格与性能优化‌：OpenRouter通过比较不同模型的定价和性能，帮助用户找到性价比最高的选项。它还会根据用户的需求（如低成本或高吞吐量）自动路由请求到最佳提供商。
‌自动路由与回退机制‌：通过“Auto Router”功能，OpenRouter会根据输入提示选择最适合的模型。如果某个模型或提供商不可用，它会自动尝试其他替代模型，确保服务不中断。

官网：OpenRouter

在OpenRouter，可以看到模型的排名，也可以看到某个模型的使用软件排名，比如DeepSeek-V3模型的使用软件排名为：

安装和设置

安装依赖库

只需要安装openai库即可

pip install openai

如果不是代码调用，而是直接用AI工具调用 OpenRouter ，那么openai也可以省略。

获取OpenRouter秘钥

登录openrouter官网，然后创建秘钥key，记下它，以备使用。

查找模型

在这里查找模型：Models | OpenRouter

决定使用DeepSeek: DeepSeek V3 Base (free) 这个模型。当然还可以使用DeepSeek: DeepSeek V3 0324 (free) 这个模型。

API接入

测试

可以使用如下语句测试API调用：

from openai import OpenAI

client = OpenAI(
  base_url="https://openrouter.ai/api/v1",
  api_key="<OPENROUTER_API_KEY>",
)

completion = client.chat.completions.create(
  extra_headers={
    "HTTP-Referer": "<YOUR_SITE_URL>", # Optional. Site URL for rankings on openrouter.ai.
    "X-Title": "<YOUR_SITE_NAME>", # Optional. Site title for rankings on openrouter.ai.
  },
  extra_body={},
  model="deepseek/deepseek-v3-base:free",
  messages=[
    {
      "role": "user",
      "content": "What is the meaning of life?"
    }
  ]
)
print(completion.choices[0].message.content)

把自己的key填进去就行了

from openai import OpenAI

client = OpenAI(
  base_url="https://openrouter.ai/api/v1",
  api_key="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",
)

completion = client.chat.completions.create(
  extra_headers={
    "HTTP-Referer": "airoot.org", # Optional. Site URL for rankings on openrouter.ai.
    "X-Title": "airoot", # Optional. Site title for rankings on openrouter.ai.
  },
  extra_body={},
  model="deepseek/deepseek-v3-base:free",
  messages=[
    {
      "role": "user",
      "content": "What is the meaning of life?"
    }
  ]
)
print(completion.choices[0].message.content)

但是在实际执行后就卡住了，不明白什么原因(后来就好了...不知道是不是时间和网络问题)

换用CURL进行测试，有时候会有空白的回车输出。不知道是不是openai版本不对导致的？（弄明白了，就是刚开始会打好几个回车符....）

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 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" \
  -d '{
  "model": "deepseek/deepseek-chat-v3-0324:free",
  "messages": [
    {
      "role": "user",
      "content": "What is the meaning of life?"
    }
  ]
  
}'

也可用python直接调用requests进行了测试：

import requests
import json

response = requests.post(
  url="https://openrouter.ai/api/v1/chat/completions",
  headers={
    "Authorization": "Bearer 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",
    "Content-Type": "application/json",
    "HTTP-Referer": "airoot.org", # Optional. Site URL for rankings on openrouter.ai.
    "X-Title": "airoot", # Optional. Site title for rankings on openrouter.ai.
  },
  data=json.dumps({
    "model": "deepseek/deepseek-chat-v3-0324:free",
    "messages": [
      {
        "role": "user",
        "content": "What is the meaning of life?"
      }
    ],
    
  })
)
print(response.content)

测试通过，输出：

print(response.content)
b'\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n\n         \n{"id":"gen-1743689975-7NxUuvZaolfKKM9NJaz7","provider":"Chutes","model":"deepseek/deepseek-chat-v3-0324","object":"chat.completion","created":1743689975,"choices":[{"logprobs":null,"finish_reason":"stop","native_finish_reason":"stop","index":0,"message":{"role":"assistant","content":"The meaning of life is one of the most profound and debated questions in philosophy, religion, science, and personal reflection. Different perspectives offer various answers:\\n\\n### 1. **Philosophical Perspectives**  \\n   - **Existentialism (e.g., Sartre, Camus):** Life has no inherent meaning\xe2\x80\x94it\xe2\x80\x99s up to each individual to create their own purpose through choices and actions.  \\n   - **Absurdism (Camus):** The search for meaning in a meaningless universe is absurd, but we must embrace life passionately anyway.  \\n   - **Stoicism:** Meaning comes from living virtuously, accepting what we can\xe2\x80\x99t control, and focusing on inner peace.  \\n\\n### 2. **Religious/Spiritual Views**  \\n   - **Theistic religions (Christianity, Islam, Hinduism, etc.):** Life\xe2\x80\x99s purpose is tied to divine will\xe2\x80\x94serving God, achieving enlightenment, or fulfilling a spiritual destiny.  \\n   - **Buddhism:** Meaning arises from ending suffering (dukkha) through enlightenment (nirvana) and compassion.  \\n\\n### 3. **Scientific Perspectives**  \\n   - **Evolutionary Biology:** Life\xe2\x80\x99s \\"purpose\\" is survival and reproduction, but humans seek deeper significance beyond biology.  \\n   - **Cosmology:** In a vast, indifferent universe, meaning is a human construct\xe2\x80\x94we give it value through curiosity, connection, and exploration.  \\n\\n### 4. **Personal Meaning**  \\n   Many find purpose in relationships, creativity, helping others, personal growth, or leaving a legacy. Viktor Frankl (Holocaust survivor and psychiatrist) argued that meaning comes from suffering with dignity, love, and purposeful work.  \\n\\n### **A Practical Answer?**  \\nThere\xe2\x80\x99s no single \\"correct\\" answer\xe2\x80\x94it\xe2\x80\x99s a personal journey. You might explore:  \\n- What brings you joy or fulfillment?  \\n- How do you impact others?  \\n- What legacy do you want to leave?  \\n\\nWould you like insights from a specific tradition or thinker?","refusal":null}}],"usage":{"prompt_tokens":10,"completion_tokens":417,"total_tokens":427}}'