[{"data":1,"prerenderedAt":1315},["ShallowReactive",2],{"header-counts":3,"footer-counts":6,"compare-one-api-vs-openrouter":9,"compare-a-one-api":10,"compare-b-openrouter":773},{"tools":4,"reviews":5},78,26,{"tools":4,"reviews":5,"playbooks":7,"news":8},22,21,null,{"id":11,"title":12,"alternatives":13,"api_compatible":9,"body":18,"category":707,"chinese_friendly":281,"cover":708,"description":709,"domestic":710,"extension":711,"faq":712,"free":710,"github":9,"languages":725,"lastVerified":9,"meta":728,"models":9,"navigation":305,"notSuitable":9,"opensource":305,"path":729,"pillar":730,"platforms":731,"priceTable":734,"pricing":121,"published":745,"relatedPlaybooks":746,"relatedReviews":9,"score":748,"self_host":305,"seo":749,"seoTitle":9,"slug":750,"sources":751,"stem":761,"suitable":9,"tagline":762,"tags":763,"updated":754,"verdict":771,"website":682,"__hash__":772},"tools\u002Ftools\u002Fcoding\u002Fapi\u002Fone-api.md","One-API",[14,15,16,17],"coding\u002Fapi\u002Flitellm","coding\u002Fapi\u002Fopenrouter","coding\u002Fapi\u002Fportkey","coding\u002Fapi\u002Fhelicone",{"type":19,"value":20,"toc":695},"minimark",[21,26,35,38,41,112,115,129,135,139,144,169,174,200,204,355,358,535,538,593,597,626,629,656,659,691],[22,23,25],"h2",{"id":24},"tldr","TL;DR",[27,28,29,30,34],"p",{},"One-API 是国内最流行的开源 LLM API 网关——JustSong 用 Go 写的 OpenAI 兼容代理，GitHub 18K+ Star，",[31,32,33],"code",{},"docker run"," 一行起一个能用的 AI API 平台。30+ 厂商（海外 + 国内全覆盖）统一 OpenAI 格式，内置中文 UI + Key 管理 + 渠道分组 + 负载均衡 + 额度系统 + 邀请返佣。衍生项目 new-api（QuantumNous）增强多租户、缓存独立计费、内置 EPay \u002F Stripe 支付、Claude \u002F Gemini 原生格式、多种登录方式——已成为商业化中转站的事实底座。",[27,36,37],{},"适合：国内个人 \u002F 小团队自建 LLM 网关 + 多账号轮询；企业内部统一多厂商 API 入口 + 中文运营；学习 LLM 网关架构。不适合：微服务架构 \u002F 多语言客户端（走 LiteLLM）；不想运维（走 OpenRouter \u002F Portkey）；向中国境内公众提供未备案服务（违法）。",[22,39,40],{"id":40},"核心能力",[42,43,44,52,58,64,70,76,82,88,94,100,106],"ul",{},[45,46,47,51],"li",{},[48,49,50],"strong",{},"30+ 厂商","：OpenAI \u002F Claude \u002F Gemini \u002F Mistral \u002F Groq \u002F xAI；DeepSeek \u002F 通义 \u002F 文心 \u002F 讯飞 \u002F 智谱 \u002F 豆包 \u002F Moonshot \u002F 百川 \u002F MiniMax \u002F 零一万物 \u002F 阶跃星辰；Ollama \u002F Cloudflare Workers AI 等",[45,53,54,57],{},[48,55,56],{},"Key 管理","：生成 \u002F 分发 \u002F 过期 \u002F 额度控制",[45,59,60,63],{},[48,61,62],{},"渠道分组","：批量创建 \u002F 分组 \u002F 模型映射",[45,65,66,69],{},[48,67,68],{},"负载均衡","：多 Key 轮询 + 失败自动重试",[45,71,72,75],{},[48,73,74],{},"额度系统","：用户额度 \u002F 兑换码 \u002F 邀请返佣",[45,77,78,81],{},[48,79,80],{},"日志监控","：请求日志 \u002F 额度明细 \u002F 报警",[45,83,84,87],{},[48,85,86],{},"权限控制","：IP 白名单 \u002F Token 分组 \u002F 模型限制",[45,89,90,93],{},[48,91,92],{},"多输出格式","：OpenAI \u002F Claude \u002F Gemini 原生（new-api）",[45,95,96,99],{},[48,97,98],{},"多登录方式","：邮箱 \u002F GitHub \u002F 飞书；new-api 加 Discord \u002F Telegram \u002F LinuxDO \u002F OIDC",[45,101,102,105],{},[48,103,104],{},"Docker 一键部署","：SQLite（小规模）\u002F MySQL（生产）",[45,107,108,111],{},[48,109,110],{},"多语言 UI","：中文 \u002F 英文 \u002F 日文",[22,113,114],{"id":114},"价格",[42,116,117,123,126],{},[45,118,119,122],{},[48,120,121],{},"MIT 开源免费","，自托管成本 = 1 台 VPS（最小 1 核 1G 跑 SQLite 版）",[45,124,125],{},"上游模型成本走各厂商直接结算",[45,127,128],{},"new-api 内置 EPay \u002F Stripe 支付，可对接支付宝当面付 \u002F 微信支付（自行二开）",[130,131,132],"blockquote",{},[27,133,134],{},"部署起步：阿里云 \u002F 腾讯云轻量 1 核 1G 月 ¥30，配 Cloudflare CDN 全套月不到 ¥50。",[22,136,138],{"id":137},"实测5-人创业团队-内部统一-api-入口","实测（5 人创业团队 + 内部统一 API 入口）",[27,140,141],{},[48,142,143],{},"亮点：",[42,145,146,151,154,157,160,163,166],{},[45,147,148,150],{},[31,149,33],{}," 一行 5 分钟拉起 + 中文 UI 上手 0 摩擦",[45,152,153],{},"多 Key 轮询解决 OpenAI \u002F Anthropic 单 Key 限流",[45,155,156],{},"国内模型全 + 统一 OpenAI 接口，业务代码 0 修改切换",[45,158,159],{},"额度系统给每人发 token，成本归因清晰",[45,161,162],{},"new-api 仪表盘 + 缓存计费让 prompt caching 优化看得见",[45,164,165],{},"new-api 内置 EPay 支付对 B2B 中转站很方便",[45,167,168],{},"二次开发简单：Go 单仓 + 前端 React，加渠道 \u002F 改 logo 都不难",[27,170,171],{},[48,172,173],{},"踩坑：",[42,175,176,179,182,185,188,191,194,197],{},[45,177,178],{},"默认账号 root \u002F 123456 不改是大坑，公网暴露 = 资产被滥用",[45,180,181],{},"SQLite 版只适合个人 \u002F \u003C10 用户，团队 \u002F 生产必须 MySQL",[45,183,184],{},"文档以中文 README 为主，国际化弱",[45,186,187],{},"原版 one-api 缺多租户 + 缓存计费 + 仪表盘，生产几乎都得切 new-api",[45,189,190],{},"上游模型轮询时单点失败重试策略不如 LiteLLM 三类 fallback 细",[45,192,193],{},"高并发场景需要 Redis 配合做限流",[45,195,196],{},"部分上游厂商接口变更后需手动跟进升级",[45,198,199],{},"合规：未备案对外服务面临监管风险，企业内部用没问题",[22,201,203],{"id":202},"上手new-api-推荐","上手（new-api 推荐）",[205,206,211],"pre",{"className":207,"code":208,"language":209,"meta":210,"style":210},"language-bash shiki shiki-themes github-light github-dark","# MySQL 生产版\ndocker run --name new-api -d --restart always -p 3000:3000 \\\n  -e SQL_DSN=\"root:pass@tcp(host:3306)\u002Fnewapi\" \\\n  -e TZ=Asia\u002FShanghai \\\n  -v $PWD\u002Fdata:\u002Fdata \\\n  calciumion\u002Fnew-api:latest\n\n# 访问 http:\u002F\u002Flocalhost:3000\n# 1. 改 root 密码 + 关注册 + 加 IP 白名单\n# 2. 渠道管理 → 添加上游（OpenAI \u002F Anthropic \u002F DeepSeek Key）\n# 3. 设模型映射 + 倍率\n# 4. 用户管理 → 生成 token 给业务方\n# 5. 业务方调用：\n#    baseURL = https:\u002F\u002Fyour-domain\u002Fv1\n#    api_key = sk-xxx-from-newapi\n","bash","",[31,212,213,222,258,269,279,294,300,307,313,319,325,331,337,343,349],{"__ignoreMap":210},[214,215,218],"span",{"class":216,"line":217},"line",1,[214,219,221],{"class":220},"sJ8bj","# MySQL 生产版\n",[214,223,225,229,233,237,240,243,246,249,252,255],{"class":216,"line":224},2,[214,226,228],{"class":227},"sScJk","docker",[214,230,232],{"class":231},"sZZnC"," run",[214,234,236],{"class":235},"sj4cs"," --name",[214,238,239],{"class":231}," new-api",[214,241,242],{"class":235}," -d",[214,244,245],{"class":235}," --restart",[214,247,248],{"class":231}," always",[214,250,251],{"class":235}," -p",[214,253,254],{"class":231}," 3000:3000",[214,256,257],{"class":235}," \\\n",[214,259,261,264,267],{"class":216,"line":260},3,[214,262,263],{"class":235},"  -e",[214,265,266],{"class":231}," SQL_DSN=\"root:pass@tcp(host:3306)\u002Fnewapi\"",[214,268,257],{"class":235},[214,270,272,274,277],{"class":216,"line":271},4,[214,273,263],{"class":235},[214,275,276],{"class":231}," TZ=Asia\u002FShanghai",[214,278,257],{"class":235},[214,280,282,285,289,292],{"class":216,"line":281},5,[214,283,284],{"class":235},"  -v",[214,286,288],{"class":287},"sVt8B"," $PWD",[214,290,291],{"class":231},"\u002Fdata:\u002Fdata",[214,293,257],{"class":235},[214,295,297],{"class":216,"line":296},6,[214,298,299],{"class":231},"  calciumion\u002Fnew-api:latest\n",[214,301,303],{"class":216,"line":302},7,[214,304,306],{"emptyLinePlaceholder":305},true,"\n",[214,308,310],{"class":216,"line":309},8,[214,311,312],{"class":220},"# 访问 http:\u002F\u002Flocalhost:3000\n",[214,314,316],{"class":216,"line":315},9,[214,317,318],{"class":220},"# 1. 改 root 密码 + 关注册 + 加 IP 白名单\n",[214,320,322],{"class":216,"line":321},10,[214,323,324],{"class":220},"# 2. 渠道管理 → 添加上游（OpenAI \u002F Anthropic \u002F DeepSeek Key）\n",[214,326,328],{"class":216,"line":327},11,[214,329,330],{"class":220},"# 3. 设模型映射 + 倍率\n",[214,332,334],{"class":216,"line":333},12,[214,335,336],{"class":220},"# 4. 用户管理 → 生成 token 给业务方\n",[214,338,340],{"class":216,"line":339},13,[214,341,342],{"class":220},"# 5. 业务方调用：\n",[214,344,346],{"class":216,"line":345},14,[214,347,348],{"class":220},"#    baseURL = https:\u002F\u002Fyour-domain\u002Fv1\n",[214,350,352],{"class":216,"line":351},15,[214,353,354],{"class":220},"#    api_key = sk-xxx-from-newapi\n",[22,356,357],{"id":357},"对比",[359,360,361,382],"table",{},[362,363,364],"thead",{},[365,366,367,371,373,376,379],"tr",{},[368,369,370],"th",{},"维度",[368,372,12],{},[368,374,375],{},"new-api",[368,377,378],{},"LiteLLM",[368,380,381],{},"OpenRouter",[383,384,385,402,418,431,446,460,474,490,504,520],"tbody",{},[365,386,387,391,394,396,399],{},[388,389,390],"td",{},"语言",[388,392,393],{},"Go",[388,395,393],{},[388,397,398],{},"Python",[388,400,401],{},"–",[365,403,404,407,410,413,416],{},[388,405,406],{},"多租户",[388,408,409],{},"❌",[388,411,412],{},"✅",[388,414,415],{},"✅ (Enterprise)",[388,417,409],{},[365,419,420,423,425,427,429],{},[388,421,422],{},"缓存独立计费",[388,424,409],{},[388,426,412],{},[388,428,401],{},[388,430,401],{},[365,432,433,436,438,441,443],{},[388,434,435],{},"内置支付",[388,437,409],{},[388,439,440],{},"EPay \u002F Stripe",[388,442,409],{},[388,444,445],{},"❌（卡 + USDC）",[365,447,448,451,454,456,458],{},[388,449,450],{},"中文支付二开",[388,452,453],{},"✅ 易",[388,455,453],{},[388,457,401],{},[388,459,401],{},[365,461,462,465,467,469,472],{},[388,463,464],{},"中文 UI",[388,466,412],{},[388,468,412],{},[388,470,471],{},"英文",[388,473,471],{},[365,475,476,479,482,484,487],{},[388,477,478],{},"国内模型覆盖",[388,480,481],{},"✅ 全",[388,483,481],{},[388,485,486],{},"部分",[388,488,489],{},"中等",[365,491,492,495,497,499,501],{},[388,493,494],{},"Claude 原生格式",[388,496,409],{},[388,498,412],{},[388,500,412],{},[388,502,503],{},"OpenAI 兼容",[365,505,506,509,512,515,518],{},[388,507,508],{},"GitHub Star",[388,510,511],{},"18K+",[388,513,514],{},"增长快",[388,516,517],{},"高",[388,519,401],{},[365,521,522,525,528,530,533],{},[388,523,524],{},"部署难度",[388,526,527],{},"⭐",[388,529,527],{},[388,531,532],{},"⭐⭐",[388,534,401],{},[22,536,537],{"id":537},"避坑",[42,539,540,545,551,557,563,569,575,581,587],{},[45,541,542],{},[48,543,544],{},"第一件事改 root 密码 + 关公开注册 + 加 IP 白名单",[45,546,547,550],{},[48,548,549],{},"生产用 MySQL 不要 SQLite","：SQLite 并发上千就吃力",[45,552,553,556],{},[48,554,555],{},"加 Cloudflare CDN + WAF","：上游厂商风控会按出口 IP，扛不住会被拉黑",[45,558,559,562],{},[48,560,561],{},"渠道倍率别贪 0.1","：太低用户烧得快 + 上游被你做穿",[45,564,565,568],{},[48,566,567],{},"充值流水必须留痕","：EPay \u002F 自二开支付要符合发票 \u002F 反洗钱要求",[45,570,571,574],{},[48,572,573],{},"算法备案","：对中国境内公众提供生成式 AI 服务必须备案，否则违法",[45,576,577,580],{},[48,578,579],{},"上游条款","：OpenAI \u002F Anthropic \u002F 国内厂商基本都禁止未授权转售 API，自用 OK，商业化要拿合作授权",[45,582,583,586],{},[48,584,585],{},"缓存计费 (new-api)","：开 prompt caching 后单价不同，账单要看明细",[45,588,589,592],{},[48,590,591],{},"国内访问外网模型","：服务器要部署在能直连厂商的节点（如香港 \u002F 美西）+ 反向代理给国内用户",[22,594,596],{"id":595},"适合-不适合","适合 \u002F 不适合",[42,598,599,602,605,608,611,614,617,620,623],{},[45,600,601],{},"✅ 国内个人 \u002F 小团队自建 LLM 网关",[45,603,604],{},"✅ 企业内部统一多厂商 API 入口",[45,606,607],{},"✅ 学习 LLM 网关架构 \u002F 二次开发",[45,609,610],{},"✅ 国内模型 + 海外模型混用",[45,612,613],{},"✅ 中文运营 + 国内支付",[45,615,616],{},"❌ 微服务 \u002F 多语言客户端（走 LiteLLM）",[45,618,619],{},"❌ 不想运维（走 OpenRouter \u002F Portkey）",[45,621,622],{},"❌ 向中国境内公众提供未备案服务（违法）",[45,624,625],{},"❌ 国际化产品 \u002F 多语言文档需求",[22,627,628],{"id":628},"相关阅读",[42,630,631,638,644,650],{},[45,632,633],{},[634,635,637],"a",{"href":636},"\u002Ftools\u002Fcoding\u002Fapi\u002Flitellm","LiteLLM 评测",[45,639,640],{},[634,641,643],{"href":642},"\u002Ftools\u002Fcoding\u002Fapi\u002Fopenrouter","OpenRouter 评测",[45,645,646],{},[634,647,649],{"href":648},"\u002Ftools\u002Fcoding\u002Fapi\u002Fportkey","Portkey 评测",[45,651,652],{},[634,653,655],{"href":654},"\u002Ftools\u002Fcoding\u002Fapi\u002Fhelicone","Helicone 评测",[22,657,658],{"id":658},"来源",[660,661,662,670,677,684],"ol",{},[45,663,664,665],{},"CSDN — One-API vs New-API 2026 选型与部署踩坑 ",[634,666,667],{"href":667,"rel":668},"https:\u002F\u002Fblog.csdn.net\u002Fofoxcoding\u002Farticle\u002Fdetails\u002F158886435",[669],"nofollow",[45,671,672,673],{},"DeepSeek 社区 — 2026 LLM API 中转站技术全景（含 new-api 增强能力对比表）",[634,674,675],{"href":675,"rel":676},"https:\u002F\u002Fdevpress.csdn.net\u002Fv1\u002Farticle\u002Fdetail\u002F161060038",[669],[45,678,679,680],{},"GitHub — songquanpeng\u002Fone-api ",[634,681,682],{"href":682,"rel":683},"https:\u002F\u002Fgithub.com\u002Fsongquanpeng\u002Fone-api",[669],[45,685,686,687],{},"GitHub — QuantumNous\u002Fnew-api ",[634,688,689],{"href":689,"rel":690},"https:\u002F\u002Fgithub.com\u002FQuantumNous\u002Fnew-api",[669],[692,693,694],"style",{},"html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":210,"searchDepth":260,"depth":260,"links":696},[697,698,699,700,701,702,703,704,705,706],{"id":24,"depth":224,"text":25},{"id":40,"depth":224,"text":40},{"id":114,"depth":224,"text":114},{"id":137,"depth":224,"text":138},{"id":202,"depth":224,"text":203},{"id":357,"depth":224,"text":357},{"id":537,"depth":224,"text":537},{"id":595,"depth":224,"text":596},{"id":628,"depth":224,"text":628},{"id":658,"depth":224,"text":658},"api","\u002Fimg\u002Ftools\u002Fone-api.webp","One-API 真实评测：JustSong 维护的开源 LLM API 网关（GitHub 18K+ Star，Go 语言）。把 30+ 海内外厂商 API 统一成 OpenAI 格式，内置中文 UI + Key 管理 + 渠道分组 + 负载均衡 + 额度兑换 + IP 白名单 + 邀请返佣。`docker run` 一行起。衍生 new-api 增强多租户 \u002F 缓存计费 \u002F 内置 EPay 支付。",false,"md",[713,716,719,722],{"q":714,"a":715},"One-API 和 new-api 怎么选？","个人 \u002F 小团队内部用：one-api 已够。要做面向 B2B \u002F 商业化 \u002F 中文支付：new-api 多租户 + EPay\u002FStripe + 缓存独立计费 + 仪表盘更专业。new-api 是 one-api 二次开发版本，在生产场景已经全面超越原版。",{"q":717,"a":718},"支持哪些模型？","海外：OpenAI \u002F Anthropic Claude \u002F Google Gemini \u002F Mistral \u002F Groq \u002F Cohere \u002F xAI。国内：DeepSeek \u002F 通义千问 \u002F 文心一言 \u002F 讯飞星火 \u002F ChatGLM \u002F 豆包 \u002F 腾讯混元 \u002F 360 智脑 \u002F Moonshot \u002F 百川 \u002F MiniMax \u002F 零一万物 \u002F 阶跃星辰。本地：Ollama \u002F Cloudflare Workers AI。",{"q":720,"a":721},"默认密码记得改","Docker 拉起后默认账号 root \u002F 密码 123456。官方 README 已经反复警告但大量公开暴露的中转站连这一步都没做——上线前第一件事改密码 + 关注册 + 加 IP 白名单。",{"q":723,"a":724},"搭建中转站合规吗？","one-api \u002F new-api 本身是中立技术工具，合法场景：(1) 企业内部统一管理多厂商 API；(2) 个人学习研究；(3) 与上游签订正式合作的 B2B 服务。向中国境内公众提供生成式 AI 服务，依据《生成式人工智能服务管理暂行办法》必须完成算法备案 + 内容安全责任 + 投诉举报机制。未授权代理 \u002F 转售 OpenAI \u002F Anthropic API 违反上游条款。",[726,727],"zh","en",{},"\u002Ftools\u002Fcoding\u002Fapi\u002Fone-api","coding",[228,732,733],"linux","windows",[735,740],{"plan":736,"price":737,"features":738,"notes":739},"one-api（原版）","$0（MIT）","30+ 厂商统一 OpenAI 格式 + Key 管理 + 渠道分组 + 负载均衡 + 额度系统 + 多语言 UI","songquanpeng\u002Fone-api",{"plan":741,"price":742,"features":743,"notes":744},"new-api（增强版）","$0","原版 + 多租户 + 缓存计费 + 内置 EPay\u002FStripe + Discord\u002FTelegram\u002FLinuxDO 登录 + Claude\u002FGemini 原生格式","QuantumNous\u002Fnew-api","2026-06-19",[747],"onboarding\u002Fclaude-code-getting-started",{"power":271,"ux":271,"price":281,"cn_support":281,"stability":271},{"title":12,"description":709},"coding\u002Fapi\u002Fone-api",[752,755,757,759],{"name":753,"url":667,"accessed":754},"CSDN — One-API vs New-API 2026 选型与踩坑","2026-06-24",{"name":756,"url":675,"accessed":754},"DeepSeek 社区 — 2026 LLM API 中转站技术全景",{"name":758,"url":682,"accessed":754},"GitHub — songquanpeng\u002Fone-api",{"name":760,"url":689,"accessed":754},"GitHub — QuantumNous\u002Fnew-api","tools\u002Fcoding\u002Fapi\u002Fone-api","国内最流行的开源 LLM 网关——Go + Docker 一键起，30+ 厂商统一 OpenAI 格式，中文 UI + 充值系统",[764,765,766,767,768,769,770],"llm-gateway","opensource","mit","chinese","go","openai-compatible","self-host","国内开发者自建 LLM 网关首选——中文 UI + 国内模型全 + EPay 支付。海外团队 \u002F 多语言客户端 \u002F 微服务架构走 LiteLLM；面向中国境内公众提供服务需依法备案。","SifC2sjd2b5dMR5eSCj6GUwuMNXOHmyZ0LYFULlDzfc",{"id":774,"title":381,"alternatives":775,"api_compatible":9,"body":776,"category":707,"chinese_friendly":224,"cover":1253,"description":1254,"domestic":710,"extension":711,"faq":1255,"free":710,"github":9,"languages":1268,"lastVerified":9,"meta":1269,"models":9,"navigation":305,"notSuitable":9,"opensource":710,"path":642,"pillar":730,"platforms":1270,"priceTable":1272,"pricing":1288,"published":745,"relatedPlaybooks":1289,"relatedReviews":1291,"score":1293,"self_host":710,"seo":1294,"seoTitle":9,"slug":15,"sources":1295,"stem":1304,"suitable":9,"tagline":1305,"tags":1306,"updated":754,"verdict":1312,"website":1313,"__hash__":1314},"tools\u002Ftools\u002Fcoding\u002Fapi\u002Fopenrouter.md",[14,750,16,17],{"type":19,"value":777,"toc":1241},[778,780,783,786,788,865,867,898,903,907,911,928,933,957,960,992,994,1117,1119,1157,1159,1188,1190,1209,1211],[22,779,25],{"id":24},[27,781,782],{},"OpenRouter 是 AI API 聚合先驱——一个 OpenAI 兼容 endpoint + 一个 Key，调 60+ 厂商 300+ 模型，5M+ 用户。模型 passthrough 定价 0 markup，但充值有 5.5% 信用卡平台费（$0.80 最低）+ BYOK 月 100 万请求后 5%。自动 fallback \u002F playground \u002F 海量模型选型是杀手锏。国内直连延迟 1500–3000ms + 不支持支付宝是硬伤。",[27,784,785],{},"适合：海外开发者；多模型选型 \u002F 横评；生产 fallback 高可用；零迁移成本（OpenAI SDK 改 baseURL）。不适合：国内对延迟敏感的 AI 编程工具（用 OfoxAI \u002F 自建中转）；要支付宝 \u002F 微信 \u002F 银联；要 self-host（用 one-api \u002F LiteLLM）。",[22,787,40],{"id":40},[42,789,790,796,806,819,829,835,841,847,853,859],{},[45,791,792,795],{},[48,793,794],{},"60+ 厂商 300+ 模型","：OpenAI \u002F Anthropic \u002F Google \u002F Meta \u002F DeepSeek \u002F MiniMax \u002F Mistral \u002F Cohere \u002F xAI \u002F NVIDIA \u002F Qwen \u002F 字节豆包 等",[45,797,798,801,802,805],{},[48,799,800],{},"OpenAI 兼容 endpoint","：",[31,803,804],{},"https:\u002F\u002Fopenrouter.ai\u002Fapi\u002Fv1","，SDK 改 baseURL 即用",[45,807,808,801,811,814,815,818],{},[48,809,810],{},"模型 ID 格式",[31,812,813],{},"provider\u002Fmodel-name","（如 ",[31,816,817],{},"anthropic\u002Fclaude-sonnet-4.6","）",[45,820,821,824,825,828],{},[48,822,823],{},"自动 fallback","：请求里列 ",[31,826,827],{},"models: [...]","，前者失败自动切后者",[45,830,831,834],{},[48,832,833],{},"Playground","：5 模型并排测同 prompt + 成本 + 延迟 + 输出",[45,836,837,840],{},[48,838,839],{},"BYOK","：自带 OpenAI \u002F Anthropic Key，OpenRouter 只做网关；前 100 万 req\u002F月免费，超 5% fee",[45,842,843,846],{},[48,844,845],{},"Passthrough 定价","：模型按厂商官方价",[45,848,849,852],{},[48,850,851],{},"免费模型","：Llama 4 Scout \u002F DeepSeek V4 Flash \u002F Qwen3 Coder \u002F Gemma 3 等，每日 5\u002F200 次",[45,854,855,858],{},[48,856,857],{},"Provider ranking \u002F SLA","：dashboard 看每家 provider 延迟 + 错误率",[45,860,861,864],{},[48,862,863],{},"Rankings 页","：模型按 token 消耗排名（市场热度参考）",[22,866,114],{"id":114},[42,868,869,875,881,887,893],{},[45,870,871,874],{},[48,872,873],{},"Free","：$1 credit + 免费模型 5\u002F日 + 标准限流",[45,876,877,880],{},[48,878,879],{},"Pay-as-you-go","：模型 passthrough + 5.5% 卡费（最低 $0.80）+ 充值 $5 后免费模型涨到 200\u002F日",[45,882,883,886],{},[48,884,885],{},"Team","：$99\u002F月 + Priority routing + 99.9% SLA",[45,888,889,892],{},[48,890,891],{},"Enterprise","：Custom 专属基础设施",[45,894,895,897],{},[48,896,839],{},"：前 100 万 req\u002F月免费，超出 5%",[130,899,900],{},[27,901,902],{},"实际总成本 ≈ 模型价 × (1 + 5.5%) + BYOK 5% × 月 >1M 部分。预算按 5–7% overhead 算。",[22,904,906],{"id":905},"实测小型-saas-后端-海外节点","实测（小型 SaaS 后端 \u002F 海外节点）",[27,908,909],{},[48,910,143],{},[42,912,913,916,919,922,925],{},[45,914,915],{},"5 分钟接入，OpenAI SDK 改两行配置",[45,917,918],{},"Playground 横评新模型省一大堆 boilerplate",[45,920,921],{},"自动 fallback 救命：Anthropic 4 小时宕机时应用零中断",[45,923,924],{},"模型 ID 提示器 + Rankings 看市场热度方便选型",[45,926,927],{},"海外节点延迟 300–600ms，CDN 体感好",[27,929,930],{},[48,931,932],{},"踩坑（国内）：",[42,934,935,938,941,944,951,954],{},[45,936,937],{},"国内直连 1500–3000ms + 高峰超时率明显，Cursor \u002F Claude Code 高频调用体感糟",[45,939,940],{},"不支持支付宝 \u002F 微信 \u002F 银联，只 Visa\u002FMastercard \u002F USDC",[45,942,943],{},"信用卡费 5.5% 最低 $0.80，\u003C$15 充值实际打到 10%+",[45,945,946,947,950],{},"模型 ID 点号分隔（",[31,948,949],{},"claude-sonnet-4.6","）易跟连字符混",[45,952,953],{},"Claude Code 默认走 Anthropic 原生协议，OpenRouter 适配偶有不一致",[45,955,956],{},"「免费模型」rate limit 后可能静默切付费",[22,958,959],{"id":959},"上手",[660,961,962,965,968,971,977,983,989],{},[45,963,964],{},"openrouter.ai → Google \u002F GitHub OAuth 注册",[45,966,967],{},"Keys → 创建 API Key（sk-or-xxx）",[45,969,970],{},"充值 $10+（Visa \u002F Mastercard \u002F USDC）→ 解锁更高免费配额",[45,972,973,974],{},"代码：",[31,975,976],{},"OpenAI(baseURL='https:\u002F\u002Fopenrouter.ai\u002Fapi\u002Fv1', api_key=KEY)",[45,978,979,980,982],{},"模型用 ",[31,981,813],{}," 格式",[45,984,985,986],{},"加 fallback：",[31,987,988],{},"extra_body={\"models\": [\"anthropic\u002Fclaude-sonnet-4.6\", \"openai\u002Fgpt-5.4\"]}",[45,990,991],{},"Playground 横评再批量切",[22,993,357],{"id":357},[359,995,996,1011],{},[362,997,998],{},[365,999,1000,1002,1004,1006,1008],{},[368,1001,370],{},[368,1003,381],{},[368,1005,378],{},[368,1007,12],{},[368,1009,1010],{},"Portkey",[383,1012,1013,1029,1046,1059,1072,1085,1101],{},[365,1014,1015,1018,1021,1024,1027],{},[388,1016,1017],{},"形态",[388,1019,1020],{},"SaaS",[388,1022,1023],{},"OSS + SaaS",[388,1025,1026],{},"OSS",[388,1028,1020],{},[365,1030,1031,1034,1037,1040,1043],{},[388,1032,1033],{},"模型数",[388,1035,1036],{},"300+",[388,1038,1039],{},"100+",[388,1041,1042],{},"30+",[388,1044,1045],{},"250+",[365,1047,1048,1051,1053,1055,1057],{},[388,1049,1050],{},"自托管",[388,1052,409],{},[388,1054,412],{},[388,1056,412],{},[388,1058,891],{},[365,1060,1061,1064,1066,1068,1070],{},[388,1062,1063],{},"中文支付",[388,1065,409],{},[388,1067,401],{},[388,1069,412],{},[388,1071,401],{},[365,1073,1074,1077,1079,1081,1083],{},[388,1075,1076],{},"Fallback",[388,1078,412],{},[388,1080,412],{},[388,1082,412],{},[388,1084,412],{},[365,1086,1087,1090,1093,1096,1098],{},[388,1088,1089],{},"国内延迟",[388,1091,1092],{},"1500–3000ms",[388,1094,1095],{},"自托管自定",[388,1097,1095],{},[388,1099,1100],{},"海外为主",[365,1102,1103,1106,1109,1112,1114],{},[388,1104,1105],{},"成本",[388,1107,1108],{},"模型 + 5.5%\u002FBYOK 5%",[388,1110,1111],{},"自付服务器",[388,1113,1111],{},[388,1115,1116],{},"按 logs 计费",[22,1118,537],{"id":537},[42,1120,1121,1127,1133,1139,1145,1151],{},[45,1122,1123,1126],{},[48,1124,1125],{},"国内别裸用","：1500ms+ 起、超时率高，主链路上 OfoxAI \u002F 自建 one-api 中转，OpenRouter 当冷门模型补",[45,1128,1129,1132],{},[48,1130,1131],{},"预算多算 5–7%","：5.5% 信用卡 + BYOK 5% + 偶发汇率",[45,1134,1135,1138],{},[48,1136,1137],{},"免费模型生产慎用","：rate limit 后可能静默 fallback 付费，账单失控",[45,1140,1141,1144],{},[48,1142,1143],{},"模型 ID 格式坑","：点号 vs 连字符要测；新模型 ID 改名要监控",[45,1146,1147,1150],{},[48,1148,1149],{},"fallback 别堆太多","：5+ fallback 一次失败延迟叠加可能 10s+，前 2 个即可",[45,1152,1153,1156],{},[48,1154,1155],{},"Claude Code 原生模式建议直连","：OpenRouter 走 OpenAI 兼容协议有时与原生 Anthropic 协议有出入",[22,1158,596],{"id":595},[42,1160,1161,1164,1167,1170,1173,1176,1179,1182,1185],{},[45,1162,1163],{},"✅ 海外开发者 \u002F 跨境业务",[45,1165,1166],{},"✅ 多模型选型 \u002F 横评",[45,1168,1169],{},"✅ 生产 fallback 高可用",[45,1171,1172],{},"✅ 零迁移成本（OpenAI SDK 改 baseURL）",[45,1174,1175],{},"✅ BYOK 模式给团队统一 Key 管理",[45,1177,1178],{},"❌ 国内 AI 编程工具（Cursor \u002F Claude Code）高频调用",[45,1180,1181],{},"❌ 要支付宝 \u002F 微信 \u002F 银联",[45,1183,1184],{},"❌ Self-host \u002F 完全控制数据",[45,1186,1187],{},"❌ 极致低延迟实时应用",[22,1189,628],{"id":628},[42,1191,1192,1196,1201,1205],{},[45,1193,1194],{},[634,1195,637],{"href":636},[45,1197,1198],{},[634,1199,1200],{"href":729},"One-API 评测",[45,1202,1203],{},[634,1204,649],{"href":648},[45,1206,1207],{},[634,1208,655],{"href":654},[22,1210,658],{"id":658},[660,1212,1213,1220,1227,1234],{},[45,1214,1215,1216],{},"OfoxAI — OpenRouter 完全指南 2026（国内延迟实测 + 替代方案）",[634,1217,1218],{"href":1218,"rel":1219},"https:\u002F\u002Fofox.ai\u002Fzh\u002Fblog\u002Fopenrouter-complete-guide-china-developers-2026",[669],[45,1221,1222,1223],{},"OfoxAI — OpenRouter Pricing 2026 Hidden Markup Breakdown ",[634,1224,1225],{"href":1225,"rel":1226},"https:\u002F\u002Fofox.ai\u002Fblog\u002Fopenrouter-pricing-hidden-markup-breakdown-2026\u002F",[669],[45,1228,1229,1230],{},"DigitalApplied — OpenRouter June 2026 New Models & Pricing Roundup ",[634,1231,1232],{"href":1232,"rel":1233},"https:\u002F\u002Fwww.digitalapplied.com\u002Fblog\u002Fopenrouter-new-models-june-2026-roundup-pricing-rankings",[669],[45,1235,1236,1237],{},"AIToolBox — OpenRouter Review 2026 ",[634,1238,1239],{"href":1239,"rel":1240},"https:\u002F\u002Fwww.aitoolbox.hk\u002Ftools\u002Fopen-router\u002F",[669],{"title":210,"searchDepth":260,"depth":260,"links":1242},[1243,1244,1245,1246,1247,1248,1249,1250,1251,1252],{"id":24,"depth":224,"text":25},{"id":40,"depth":224,"text":40},{"id":114,"depth":224,"text":114},{"id":905,"depth":224,"text":906},{"id":959,"depth":224,"text":959},{"id":357,"depth":224,"text":357},{"id":537,"depth":224,"text":537},{"id":595,"depth":224,"text":596},{"id":628,"depth":224,"text":628},{"id":658,"depth":224,"text":658},"\u002Fimg\u002Ftools\u002Fopenrouter.webp","OpenRouter 真实评测：AI API 聚合先驱，60+ 厂商 300+ 模型一个 OpenAI 兼容 endpoint。passthrough 定价 0 markup + 5.5% 信用卡平台费（$0.80 最低）+ BYOK 5% 月千万请求外。Pay-as-you-go \u002F Team $99\u002F月 SLA \u002F Enterprise。国内直连 1500–3000ms 高峰超时多。",[1256,1259,1262,1265],{"q":1257,"a":1258},"国内能用吗？","技术上能（OpenAI SDK 改 baseURL），但服务器在海外、无国内节点：实测首 Token 延迟代理 600–1200ms \u002F 直连 1500–3000ms 且不稳，高峰超时率高。AI 编程类高频调用（Cursor \u002F Claude Code \u002F Cline）国内体验糟糕，主流方案是用 OfoxAI \u002F 自建 one-api\u002Fnew-api 中转。",{"q":1260,"a":1261},"真的零 markup 吗？","模型本身按厂商官方价 passthrough，技术上 0 markup。但充值有两层平台费：信用卡 5.5%（最低 $0.80，小额充值实际打到 10–20%）、BYOK 月 100 万请求后 5%。预算时按上层多算 5–7%。",{"q":1263,"a":1264},"自动 fallback 怎么用？","请求里加 `models: ['anthropic\u002Fclaude-sonnet-4.6', 'openai\u002Fgpt-5.4']`，前者失败 \u002F 超时 \u002F 限流时自动切到后者。生产 24h+ 不间断 AI 服务几乎刚需——Anthropic 2026 年 5 月 4 小时宕机，用 fallback 的应用零中断。",{"q":1266,"a":1267},"免费模型怎么用？","模型列表筛选 $0 价（如 Llama 4 Scout \u002F DeepSeek V4 Flash \u002F Qwen3 Coder \u002F Gemma 3）。未充值每日 5 次，充 $5+ 涨到 200 次\u002F日，附带 20 req\u002Fmin。生产别依赖免费模型，限流 \u002F 排队 \u002F 暗切付费会让计费失控。",[727,726],{},[707,1271],"sdk",[1273,1276,1280,1284],{"plan":873,"price":742,"features":1274,"notes":1275},"$1 credit + 免费模型 5\u002F日 + 标准限流","不需要信用卡",{"plan":879,"price":1277,"features":1278,"notes":1279},"Passthrough + 5.5% 卡费","300+ 模型 + 标准限流 + 充 $5 后免费模型 200\u002F日 + BYOK","信用卡平台费最低 $0.80",{"plan":885,"price":1281,"features":1282,"notes":1283},"$99\u002F月","Priority routing + 99.9% SLA + 更高限流","面向生产应用",{"plan":891,"price":1285,"features":1286,"notes":1287},"Custom","专属基础设施 + 自定义合同","大规模生产","免费 $1 credit + 5\u002F日 → 200\u002F日（充 $5+） \u002F Pay-as-you-go passthrough + 5.5% 卡费 \u002F Team $99\u002F月 SLA \u002F Enterprise",[1290,747],"onboarding\u002Frag-pipeline-build",[1292],"llm-gateway-comparison",{"power":281,"ux":271,"price":271,"cn_support":224,"stability":271},{"title":381,"description":1254},[1296,1298,1300,1302],{"name":1297,"url":1218,"accessed":754},"OfoxAI — OpenRouter 完全指南 2026",{"name":1299,"url":1225,"accessed":754},"OfoxAI — OpenRouter Pricing Hidden Markup",{"name":1301,"url":1232,"accessed":754},"DigitalApplied — OpenRouter June 2026 Roundup",{"name":1303,"url":1239,"accessed":754},"AIToolBox — OpenRouter Review 2026","tools\u002Fcoding\u002Fapi\u002Fopenrouter","AI API 聚合先驱——一个 Key + 一个 endpoint 调 300+ 模型，自动 fallback，OpenAI 兼容",[1307,1308,769,1309,1310,1311],"api-gateway","aggregator","fallback","multi-model","byok","AI API 聚合的全球事实标准——300+ 模型 \u002F 一个 Key \u002F 自动 fallback。海外开发者首选；国内开发者延迟 1500–3000ms + 不支持支付宝是硬伤，主走 OfoxAI \u002F one-api 自建中转。","https:\u002F\u002Fopenrouter.ai","baZ8onQahFHHQRNSweqSrYSNISBgcVfv7vmfrkme054",1784565441167]