硅基流动 SiliconFlow API 配置指南（含免费模型清单）

一、简介与适用场景

硅基流动是国内最省事的开源模型聚合平台：一个 Key 打通 Qwen、GLM、DeepSeek、BGE 向量模型乃至图像生成模型，全部走统一的 OpenAI 协议。对刚入门的人来说，它最大的价值在于部分小参数模型长期标注免费，你可以先用零成本把整条链路跑通，再决定要不要为更大的模型付费。

它的另一个优点是国内直连、延迟低，不需要额外的网络方案。缺点是免费模型的并发限制比较紧，做批量任务容易撞限流，而且哪些模型免费会随官方策略调整，接入前建议到模型广场确认一次当前状态。

适合看这篇的情况：国内用户想零成本起步、需要在多个开源模型之间横向对比、或者要给 RAG 应用找一个便宜的向量模型。

二、注册与获取 Key

1. 打开 硅基流动控制台 用手机号注册。
2. 完成实名认证。未实名账号的调用额度极低，很多人卡在这一步却以为是 Key 有问题。
3. 进入「API 密钥」页面点击新建，复制 sk- 开头的字符串。
4. 到「模型广场」浏览可用模型，把要用的模型 id 完整抄下来——注意 id 是 组织名/模型名 的形式，例如 Qwen/Qwen2.5-7B-Instruct，只写后半截会 404。

三、Base URL 与鉴权

• Base URL：https://api.siliconflow.cn/v1
• 鉴权方式：Authorization: Bearer sk-xxxxxxxx
• 对话端点：/chat/completions
• 向量端点：/embeddings
• 图像端点：/images/generations

模型 id 大小写敏感，qwen/qwen2.5-7b-instruct 和 Qwen/Qwen2.5-7B-Instruct 不是一回事，前者会直接返回模型不存在。复制时请从模型广场一键复制，不要手打。

四、客户端接入示例

Cherry Studio 已内置硅基流动：

1. 打开「设置 → 模型服务 → 硅基流动」。
2. API 密钥填 sk- 字符串，API 地址保持默认。
3. 点「管理」拉取模型列表，勾选你要用的几个。
4. 若客户端没有内置选项，新建一个 OpenAI 兼容供应商，地址填 https://api.siliconflow.cn/v1。
5. 首次测试建议用免费的 Qwen/Qwen2.5-7B-Instruct，验证通过再换大模型。

五、代码示例

curl：

curl https://api.siliconflow.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SILICONFLOW_API_KEY" \
  -d '{
    "model": "Qwen/Qwen2.5-7B-Instruct",
    "messages": [{"role": "user", "content": "用一句话解释什么是 API"}]
  }'

Python：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SILICONFLOW_API_KEY"],
    base_url="https://api.siliconflow.cn/v1",
)

resp = client.chat.completions.create(
    model="Qwen/Qwen2.5-7B-Instruct",
    messages=[{"role": "user", "content": "用一句话解释什么是 API"}],
)
print(resp.choices[0].message.content)

# 向量模型同样走标准接口
emb = client.embeddings.create(model="BAAI/bge-m3", input="一段待向量化的文本")
print(len(emb.data[0].embedding))

Node.js：

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.SILICONFLOW_API_KEY,
  baseURL: 'https://api.siliconflow.cn/v1',
});

const resp = await client.chat.completions.create({
  model: 'Qwen/Qwen2.5-7B-Instruct',
  messages: [{ role: 'user', content: '用一句话解释什么是 API' }],
});
console.log(resp.choices[0].message.content);

六、常见错误排查