OpenRouter 最近换了新 Logo官网视觉风格也跟着变了。如果你正在做站点素材整理、文档配图、客户端图标替换或者只是想搞清楚 OpenRouter 到底能不能用、怎么接入 Claude Code、怎么充值、怎么调用它的统一大模型 API这篇文章可以一次看完。前半段是“新 Logo 多版本下载”的实际操作后半段是 OpenRouter 从注册、获取 API Key、调用接口到接入 Claude Code 的完整流程。OpenRouter 本质上是一个“模型路由聚合平台”通过一个 OpenAI 兼容 API就能访问 Anthropic、OpenAI、Google、Meta 以及大量开源模型。对开发者来说最大的好处是切换模型不用改代码只需要改一个模型 ID对普通用户来说不用一个个去注册各家模型供应商一个 Key 就能把对话、代码补全、批量处理任务都串起来。本文会按四个步骤展开先快速看核心能力速览再详细讲新 Logo 的多个版本如何获取和整理接着是 OpenRouter 注册、API Key、额度与接口调用最后是 CC-Switch 接入 Claude Code、常见报错排查和最佳实践。全流程没有本地 GPU 依赖只要你有一台能联网的电脑按步骤操作就能跑通。1. OpenRouter 核心能力速览能力项说明项目类型大模型统一 API 聚合/路由平台主要功能通过一个 API Key 调用多个大模型支持对话、代码、长文本、工具调用等访问方式官网控制台 OpenAI 兼容 APIAPI 兼容性兼容 OpenAI Chat Completions 风格接口批量任务可以在业务代码中并发调用没有平台级队列限制需要自己实现并发与重试本地部署不需要模型在云端运行硬件要求无 GPU 要求只需要正常网络环境和客户端环境计费方式按 token 计费部分模型有免费额度以控制台展示为准常见用途多模型对比、Claude Code 接入、AI 应用后端、脚本批量文本处理适合人群开发者、AI 应用集成人员、需要快速对比模型效果的技术团队从这张表能看出来OpenRouter 不是本地部署项目而是一个“云 API 服务”。后面讲的环境准备主要围绕账号、API Key、开发依赖和网络连通性来做而不是显卡和显存。2. 新 Logo 多版本下载指南2.1 新 Logo 有哪些版本官网改版后Logo 通常会同时输出多个版本以便适配不同场景。常见的版本类型如下版本类型常见格式典型使用场景横向主标识SVG / PNG页面顶部、文档页眉、PPT图标版SVG / PNGApp 导航栏、站点 Favicon、头像深色背景版PNG / SVG深色模式界面、Banner浅色背景版PNG / SVG浅色模式界面、PDF 文档单色版SVG打印、雕刻、单色 UIFavicon 小图标ICO / PNG浏览器标签页、书签因为 OpenRouter 官网本身是 React 站点很多 Logo 资源会被打包进静态资源目录。下面给出三种自己抓取的方式不需要等官方打包下载。2.2 方法一从官网页面直接提取打开 OpenRouter 官网在页面底部或侧边栏通常能找到品牌相关入口。如果官网没有直接放下载包可以用浏览器开发者工具在官网页面右键选择“检查”或按 F12点击 Elements 面板按 CtrlF 搜索logo或brand找到img标签或 SVG 路径在资源地址上右键选择 Open in new tab在新标签页里右键保存 SVG/PNG 文件。这种方式适合提取当前正在使用的 Logo 版本。如果官网改版后保留了旧的静态资源路径你还能在 Network 面板里看到旧版 Logo 的请求记录一并下载。2.3 方法二用命令行抓取 FaviconFavicon 是最常用的小尺寸 Logo 版本可以直接用 curl 抓取# 抓取 OpenRouter 官网的 favicon curl -L -o openrouter_favicon.ico https://openrouter.ai/favicon.ico如果返回的 ICO 文件不是你想要的尺寸也可以在 HTML 源码里找更高清的图标链接# 查看页面中的 icon 声明 curl -sL https://openrouter.ai | grep -i icon | head -20根据页面源码里的link relicon或link relapple-touch-icon找到对应 PNG 路径再用 curl 下载。这里要注意网站的静态资源路径会因为部署节奏变化所以更稳妥的做法是先抓 HTML 确认实际路径再保存文件。2.4 方法三抓取静态资源目录里的 SVG如果需要 SVG 矢量版建议先看页面 Network 面板里的静态资源请求。常见路径类似https://openrouter.ai/static/media/logo.xxxxxx.svg https://openrouter.ai/assets/images/brand/logo-dark.svg这类路径通常带 hash过一段时间会失效所以不建议直接写死到文档里。更好的做法是在需要下载时打开官网用上面的 F12 方法获取当前有效路径。拿到 SVG 后可以自行转换成不同尺寸的 PNG# 使用 rsvg-convert 将 SVG 转 PNGLinux/macOS 示例 rsvg-convert -w 512 -h 512 logo.svg -o logo_512.pngWindows 用户可以安装 Inkscape或者在在线转换工具里完成转换。转换后按“主标识、图标、深色、浅色、单色”五个分类归档就形成一个自己的多版本素材库。2.5 格式选择与素材整理下载完成后建议按下面目录结构存放assets/ ├── logo/ │ ├── openrouter_logo_horizontal.svg │ ├── openrouter_logo_vertical.svg │ ├── openrouter_icon.svg │ ├── openrouter_logo_dark.png │ ├── openrouter_logo_light.png │ └── openrouter_favicon.ico如果用于大屏展示、印刷设计优先使用 SVG 矢量文件放大不失真如果只需要浏览器标签页或书签图标直接用 favicon.ico如果在文档、PPT 里使用推荐透明背景 PNG尺寸选 512×512 或 1024×1024。这样后续做客户端图标、文档插图、运维告警通知里的品牌展示都能直接取用不用每次临时去网页上截图。3. 适用场景与使用边界OpenRouter 适合的场景非常明确想用一个 Key 调用多家模型不想在多个平台之间来回切换做 AI 应用后端需要把不同模型供应商的调用统一成一套代码想快速对比不同模型的代码能力、写作能力、指令遵循能力需要把 Claude Code 接入不同模型供应商用一个统一入口管理做批量文本处理、数据清洗、内容生成需要并发调用。不适合的场景也要说清楚如果对数据隐私要求极高要求请求必须留在内网那么 OpenRouter 这种云端聚合平台不合适应该选择本地部署模型如果只需要某一家厂商的特定能力直接到对应官方平台开账号可能更稳定如果需要长期高并发生产环境建议评估 API 稳定性、故障恢复和限流策略后再决定是否作为唯一入口涉及人脸、声音、版权文本或未授权数据时不要用聚合 API 处理敏感内容必须先确认授权和合规边界。合规方面需要特别提醒使用任何大模型 API都要遵守目标平台的服务条款和当地法律法规。不要用 API 去生成违法违规内容也不要把未授权的第三方数据交给模型处理。涉及商业项目时还要留意 OpenRouter 及具体模型厂商的转发政策是否允许你的使用场景。4. 环境准备与前置条件4.1 账号与网络准备在使用 OpenRouter API 之前需要准备一个可以正常访问 OpenRouter 官网的浏览器环境一个用于注册的邮箱保证 API 服务地址https://openrouter.ai可以访问如果是开发机调用需要确保目标机器能访问外网。关于“国内能不能用”这个问题网络连通性和稳定性会因地区、运营商、时间而变化无法给一个放之四海而皆准的结论。更稳妥的做法是先在自己的电脑上打开控制台看看页面是否正常加载再用下面的接口测试命令做一次连通性测试以实际结果为准curl -sI https://openrouter.ai | head -10如果这条命令能返回 HTTP 200 和响应头说明网络链路基本可用如果超时或无响应就需要先排查本机网络、DNS 和防火墙设置。4.2 开发环境不需要安装大型框架建议准备Python 3.9requests库用于手动调用 API可选安装openaiPython SDK因为 OpenRouter 兼容 OpenAI 的调用方式如果要用 Node.js则准备 Node 18 和axios或node-fetch。安装依赖pip install requests openai如果机器上已经有 conda可以先建一个干净环境避免和现有项目冲突。4.3 API Key 与额度OpenRouter 的 API Key 在控制台页面创建。新注册用户是否有免费额度、是否需要充值建议直接登录后查看控制台右上角的余额显示以及 Models 页面里的 free 模型列表。额度策略会调整我不建议依赖第三方帖子里写的“注册送 X 美元”这种信息以官网控制台实际展示为准。如果打算长期调用付费模型就需要在控制台完成充值。支付方式通常与国际信用卡、部分外币支付渠道有关具体是否支持支付宝需要登录后看充值页面当前的支付选项。这里要提醒一句如果看到“代充”服务务必保持警惕避免账号被盗或产生纠纷。5. 注册、API Key 与模型查询5.1 注册与登录打开 OpenRouter 官网点击右上角的 Sign In 或 Get Started选择邮箱注册或第三方登录。注册完成后进入 Dashboard就能看到账户余额、API Key 列表、使用量和用量明细等入口。5.2 创建 API Key进入 Dashboard 或 API Keys 页面点击 Create Key输入 Key 名称例如dev-local或claude-code-test复制生成的 Key立即保存到本地关闭页面后可能无法再次查看完整 Key。创建的 API Key 要当作密码对待不要提交到 Git 仓库也不要写死在公开脚本里。建议写入环境变量export OPENROUTER_API_KEYsk-or-xxxxxxxx5.3 查看模型列表OpenRouter 的模型列表接口是公开的curl -sL https://openrouter.ai/api/v1/models | python3 -m json.tool | head -100返回结果里包含模型 ID、名称、上下文长度、定价等信息。模型 ID 的格式通常是“厂商/模型名”例如openai/gpt-4o、anthropic/claude-3.5-sonnet实际 ID 以模型列表为准。如果想用 Python 快速查看模型 ID 和价格import requests data requests.get(https://openrouter.ai/api/v1/models, timeout60).json() for item in data.get(data, [])[:10]: print(item.get(id)) print(item.get(pricing, {}).get(prompt))如果你在某个教程里看到模型名但在https://openrouter.ai/models页面搜不到原因通常有几种模型还没公开、模型已下线、模型 ID 拼写有误或该模型只在特定渠道灰度开放。这种情况只能在 Models 页面手动搜索确认不能凭教程里的截图判断。6. 接口 API 调用示例6.1 curl 调用对话接口OpenRouter 的接口地址为https://openrouter.ai/api/v1/chat/completions请求体和 OpenAI 基本一致。先测试连通性curl -sL https://openrouter.ai/api/v1/chat/completions \ -H Authorization: Bearer $OPENROUTER_API_KEY \ -H Content-Type: application/json \ -d { model: openai/gpt-4o-mini, messages: [ {role: user, content: 用一句话介绍你自己} ] }模型 ID 请以你在 Models 页面实际看到的为准。上面示例里的openai/gpt-4o-mini如果不存在就换成列表里的真实 ID。6.2 Python 直接调用import os import requests api_key os.environ.get(OPENROUTER_API_KEY) if not api_key: raise ValueError(请先设置 OPENROUTER_API_KEY 环境变量) url https://openrouter.ai/api/v1/chat/completions headers { Authorization: fBearer {api_key}, Content-Type: application/json, } payload { model: openai/gpt-4o-mini, messages: [ {role: system, content: 你是一个技术写作助手。}, {role: user, content: 把下面的要点改写成一段简洁的技术说明} ], temperature: 0.7, } response requests.post(url, headersheaders, jsonpayload, timeout120) response.raise_for_status() data response.json() print(data[choices][0][message][content])这里用timeout120是因为长文本生成可能超过默认的 30 秒建议按任务复杂度调整超时。常用请求参数如下参数必填说明model是模型 ID例如openai/gpt-4o-minimessages是对话消息列表包含 role 和 contenttemperature否采样温度值越高输出越随机max_tokens否最大生成 token 数stream否是否流式返回默认 false6.3 使用 OpenAI SDK 调用如果之前写的是 OpenAI 接口改成 OpenRouter 只需要修改 base_url 和 API Keyfrom openai import OpenAI import os client OpenAI( base_urlhttps://openrouter.ai/api/v1, api_keyos.environ.get(OPENROUTER_API_KEY), ) resp client.chat.completions.create( modelopenai/gpt-4o-mini, messages[ {role: user, content: 讲一下什么是 API 路由。} ], ) print(resp.choices[0].message.content)这种 SDK 兼容方式的好处是以后想换供应商只需要改base_url和api_key业务代码基本不动。6.4 批量任务与重试设计OpenRouter 本身不提供队列服务批量任务需要在脚本里自己实现并发和重试。下面是一个简单的并发批量调用示例import concurrent.futures import time import requests import os def call_one(text): url https://openrouter.ai/api/v1/chat/completions headers { Authorization: fBearer {os.environ[OPENROUTER_API_KEY]}, Content-Type: application/json, } payload { model: openai/gpt-4o-mini, messages: [{role: user, content: text}], } for attempt in range(3): try: resp requests.post(url, headersheaders, jsonpayload, timeout120) if resp.status_code 429: time.sleep(2 * (attempt 1)) continue resp.raise_for_status() return resp.json() except requests.RequestException as exc: time.sleep(2 * (attempt 1)) if attempt 2: raise exc texts [任务1, 任务2, 任务3, 任务4] with concurrent.futures.ThreadPoolExecutor(max_workers2) as executor: results list(executor.map(call_one, texts)) print(len(results))并发数建议从 2 到 3 开始先测试服务端是否稳定再逐步上调。不要一上来就开几十个并发容易触发 429 限流。6.5 429 与限流处理OpenRouter 在请求频率过高时可能返回 HTTP 429并附带重试时间。推荐的应对方式做指数退避重试第一次等 1 秒第二次等 2 秒最多重试 3 次把请求分散到不同时间窗口避免同时打出一个尖峰如果任务对实时性要求低可以串行处理或每批间隔一段时间记录请求状态码到日志方便事后分析限流原因。7. 通过 CC-Switch 接入 Claude Code7.1 CC-Switch 是什么CC-Switch 是一个用于切换 Claude Code 配置的第三方工具主要解决“本地 Claude Code 想接入不同 API 服务商”的切换问题。它可以把 Anthropic 官方、其他兼容服务、OpenRouter 这类聚合平台统一管理起来切换时不用手动改一堆配置文件。7.2 配置思路以 OpenRouter 接入 Claude Code 为例常见做法是在 OpenRouter 控制台创建一个专门给 Claude Code 使用的 API Key在 CC-Switch 中添加一个服务商配置服务商名称可以写openrouter将 OpenRouter 的 API Key 填到对应字段配置 OpenRouter 的 API 基础地址一般为https://openrouter.ai/api/v1保存配置后在 CC-Switch 中切换到 openrouter 方案启动 Claude Code确认它读取到的是 OpenRouter 的 Key 和地址。不同版本的 CC-Switch 表单字段可能不一样核心就是三个信息API Key、API 地址、模型 ID。如果你的 CC-Switch 版本里没有固定的 Base URL 输入框需要自己查看它的文档格式。7.3 找不到模型的问题排查有用户问“为什么我在 OpenRouter 的 API 配置后找不到 stealth/ox-alpha 这个模型”排查思路如下现象排查点Models 页面搜不到模型可能未公开、已下线或改过 IDAPI 返回 model not found检查模型 ID 是否拼写完整格式是否为“厂商/模型名”CC-Switch 中找不到确认 CC-Switch 版本是否支持模型列表刷新并检查网络是否能访问 OpenRouter 的模型接口列表里有但调用 404可能只对特定账号灰度开放需要登录后确认是否可见如果某个模型真的没有上架 OpenRouter那就只能换一个等价模型或者去模型原厂商使用官方 API。7.4 验证配置是否生效在使用 Claude Code 之前可以先用一条简单命令确认请求是否走到了 OpenRouter。如果配置方式是通过环境变量切换的常见变量名是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEYecho $ANTHROPIC_BASE_URL echo $ANTHROPIC_API_KEY如果输出的是 OpenRouter 地址和对应的 Key说明环境切换生效如果什么都没输出说明配置没有写入 Claude Code 实际读取的环境。也可以先发起一次最小请求观察日志里请求的 host 是否是openrouter.ai这样能直接确认流量走向。8. 资源占用与性能观察OpenRouter 本身在云端运行本地不需要 GPU 和显存。但对于把 OpenRouter 接到自己业务系统的人来说仍然要关注几类性能指标。一是接口延迟。模型生成速度和所选模型大小强相关大模型通常比小模型慢。建议在代码里记录每次请求的耗时和 token 数import time start time.time() resp_data call_model(一句话总结) elapsed time.time() - start print(f耗时: {elapsed:.2f}s) print(ftoken: {resp_data.get(usage)})二是超时设置。文本生成任务不要只给 10 秒超时建议 60 到 120 秒起步长文档任务可以更长。如果经常超时检查是模型太慢还是网络不稳定。三是成本监控。OpenRouter 按 token 计费批量任务最容易出现成本失控。建议在脚本里累计每次返回的usage.prompt_tokens和usage.completion_tokens按模型单价估算花费并给脚本设置预算上限。四是进程资源。如果批量脚本用多线程并发本地 CPU、内存、网络连接数都会上升。先在 2 个并发下压测再逐步增加并发观察本地进程是否符合预期。9. 常见问题与排查方法问题现象可能原因排查方式解决方案网页打不开或加载慢本地网络到官网连通性不稳定换网络环境执行curl -sI https://openrouter.ai查看响应使用连通性更好的网络环境以实际测试为准API 返回 401API Key 无效或未设置检查环境变量和控制台 Key重新生成 Key写入环境变量API 返回 404请求路径错误或模型 ID 不存在检查 URL 末尾是否带/chat/completions核对模型 ID修正请求路径换用 Models 页面存在的模型 IDAPI 返回 429请求频率过高或余额不足查看响应体里的错误信息、控制台余额降低并发做指数退避重试充值后再试余额扣得很快批量任务并发过大或模型单价高查看 Usage 页面按日和按模型过滤限制并发数设置月度预算优先用小 token 模型找不到某个模型模型未公开、已下线或名称拼写错误在官网 Models 页面搜索模型 ID改用等价模型或换原厂商 APICC-Switch 接入后 Claude Code 报错Key、Base URL、模型 ID 配置不一致检查 CC-Switch 配置项和控制台创建的 Key重新填写三要素并确认网络可访问 OpenRouter长文本请求超时模型生成时间长客户端超时设置太短查看模型上下文上限和响应耗时调大 timeout拆分长文本任务批量任务中途失败网络抖动、限流或单条请求出错查看日志中的 HTTP 状态码和异常堆栈增加重试机制记录失败任务断点续跑10. 最佳实践与使用建议第一Key 安全管理。OpenRouter 的 API Key 相当于账户的操作凭证里面涉及余额和请求额度。开发时用环境变量线上用密钥管理服务不要硬编码到前端代码里。第二先小规模验证。第一次接入时先用一个短提示词、低并发跑通全流程确认模型 ID、请求格式、返回结构都正确后再上批量任务。第三批量任务要有日志和断点续跑。建议把每条任务的结果写入日志或数据库失败任务单独记录脚本重启后可以跳过已完成条目避免重复扣费。第四设置成本上限。批量任务要累计 token 消耗并对照控制台用量页面对账。如果成本增长异常立刻检查是否模型 ID 选错、并发过大或请求进入死循环。第五理性看待免费模型和免费额度。免费模型适合测试和验证生产环境如果对质量、速率和稳定性有要求建议优先选择付费模型。第六不要在公开场合泄露 Key。不要为了演示方便把 Key 贴在博客、Gist 或社交平台里。一旦泄露立刻到控制台吊销并重新创建。第七涉及版权和隐私内容要谨慎。OpenRouter 是云端中转请求数据会经过第三方平台。处理用户隐私、商业机密、未授权数据前要先做合规评估。第八如果遇到复杂问题先看官方文档和控制台日志再搜索社区经验。OpenRouter 的模型列表、定价、限流策略都可能调整任何第三方教程都可能过时最终以官网为准。11. 总结这篇文章从 OpenRouter 新 Logo 多版本下载切入实际覆盖了三件事如何获取官网 Logo 的多个版本素材如何注册 OpenRouter 并完成 API Key 与基础调用以及如何把它接到 Claude Code 和批量任务中。如果你是第一次接触 OpenRouter建议按这个顺序操作先到官网确认访问是否正常注册并创建 API Key用第 6 节的 curl 命令跑通一次对话再考虑接 CC-Switch 和批量任务。最容易踩的坑是模型 ID 写错、API Key 泄露、并发过高触发 429以及轻信第三方教程里的固定配置。把自己常用模型 ID、API 地址、环境变量模板整理成一份本地笔记后面再接入项目会快很多。