SiliconFlow API 完全指南：AI 工程师必备（2026）

SiliconFlow 提供一个 OpenAI 兼容的 API 端点，汇聚 200+ 模型——DeepSeek、Qwen、GLM、Kimi、MiniMax 等等。注册后获取 API Key，将 OpenAI SDK 的 base_url 指向 https://api.siliconflow.cn/v1，现有代码无需修改即可运行。其中三个模型完全免费，无需绑定信用卡。

我们写这篇指南，是因为尽管 SiliconFlow 功能丰富，但官方文档分散在多个页面。这篇文章是我们当初将 SiliconFlow 集成到路由层时希望拥有的唯一参考。

三分钟快速上手

第一步：注册账号。 访问 cloud.siliconflow.cn，支持短信、邮箱、GitHub 和 Google OAuth 登录。

第二步：获取 API Key。 进入 API Keys 页面，点击"创建 API Key"，复制保存。

第三步：发起第一个请求。 安装 OpenAI Python SDK（如果还没装的话）：

pip install --upgrade openai

然后运行：

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_SILICONFLOW_KEY",
    base_url="https://api.siliconflow.cn/v1",
)

response = client.chat.completions.create(
    model="Qwen/Qwen3-8B",  # 免费模型
    messages=[{"role": "user", "content": "什么是 SiliconFlow？"}],
)

print(response.choices[0].message.content)

就这么简单。你刚刚调用了一个免费模型。无需信用卡，无需开通计费。

全球端点说明： SiliconFlow 还提供 https://api.siliconflow.com/v1 全球端点。.cn 端点针对中国大陆网络优化。

可用模型：你能跑什么

SiliconFlow 在单一端点上托管了多个厂商的模型。以下是截至 2026 年 6 月的主要模型系列：

价格来源：siliconflow.com/pricing，2026-06-05 获取。价格为美元/百万 token。

免费模型——零成本，无需信用卡

身份验证后，SiliconFlow 提供以下免费模型：

• Qwen3-8B — 通用对话，速度快，262K 上下文
• DeepSeek-R1-Distill-Qwen-7B — 推理蒸馏模型，适合链式思考
• DeepSeek-OCR — 文档提取，将图片转为结构化文本

免费模型有固定的速率限制（见下文速率限制章节）。如需更高吞吐量，SiliconFlow 还提供带 Pro/ 前缀的付费版本——例如 Pro/Qwen/Qwen2.5-7B-Instruct 比免费版 Qwen/Qwen2.5-7B-Instruct 有更高的速率限制。

OpenAI SDK 配置：base_url、模型映射、流式输出

基础配置（Python）

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_SILICONFLOW_KEY",
    base_url="https://api.siliconflow.cn/v1",
)

模型 ID 格式

SiliconFlow 的模型 ID 遵循 厂商/模型名 的格式：

流式输出

流式输出与 OpenAI API 完全一致：

response = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash",
    messages=[{"role": "user", "content": "用一段话解释 DNS。"}],
    stream=True,
)

for chunk in response:
    if not chunk.choices:
        continue
    delta = chunk.choices[0].delta
    if delta.content:
        print(delta.content, end="", flush=True)
    # DeepSeek R1 推理内容
    if hasattr(delta, "reasoning_content") and delta.reasoning_content:
        print(delta.reasoning_content, end="", flush=True)

注意 reasoning_content 字段——DeepSeek R1 的链式思考推理与最终答案分开返回。SiliconFlow 端到端保留了这个字段。

函数调用（Tool Use）

SiliconFlow 在部分模型上支持 OpenAI 兼容的函数调用。你只需像 OpenAI 一样传入 tools 参数：

response = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V3.2",
    messages=[{"role": "user", "content": "北京天气怎么样？"}],
    tools=[
        {
            "type": "function",
            "function": {
                "name": "get_weather",
                "description": "获取城市天气",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "city": {"type": "string", "description": "城市名称"}
                    },
                    "required": ["city"],
                },
            },
        }
    ],
)

支持函数调用的模型包括 DeepSeek R1、DeepSeek V3/V3.2、Qwen 2.5 系列（7B–72B）和 GLM-4 系列。请查阅 SiliconFlow 函数调用文档 获取最新列表。

速率限制：你需要知道的

SiliconFlow 通过多个维度衡量速率限制：

• RPM — 每分钟请求数
• TPM — 每分钟 token 数
• RPD / TPD — 每日上限
• IPM / IPD — 每分钟/每日图片数（图片生成）

按模型类别

使用等级

速率限制随月度消费额提升。SiliconFlow 采用分级体系：

等级由当月和上月消费中较高值决定。升级即时生效。

关键细节： 速率限制按账户而非 API Key 计算。创建多个 Key 不会增加额外容量。每个模型独立限额——在 DeepSeek V4 上触顶不会影响你的 Qwen 调用。

来源：SiliconFlow 速率限制文档，2026-06-05 获取。

常见错误及解决方案

429 Too Many Requests

HTTP/1.1 429 Too Many Requests
Request was rejected due to rate limiting.

解决方案： 实现指数退避重试。SiliconFlow 发布了速率限制处理示例，包含重试逻辑代码。也可以通过增加消费来提升使用等级，或联系 SiliconFlow 申请自定义速率包。

401 Unauthorized

API Key 无效或缺失。检查：

• Key 以 sk- 开头，从 cloud.siliconflow.cn/account/ak 复制
• 以 api_key 参数传入，而非手动设置 header
• 没有误用 DashScope 或 DeepSeek 的 Key

400 Model Not Found

模型 ID 与 SiliconFlow 命名不匹配。常见错误：

• 使用 deepseek-v4-pro 而非 deepseek-ai/DeepSeek-V4-Pro（大小写和厂商前缀很重要）
• 使用了近期已下线的模型——查看 SiliconFlow 发版说明 获取下线通知

流式返回空 chunk

部分模型在第一个 chunk 中返回空的 choices 数组。这是正常的——跳过即可：

for chunk in response:
    if not chunk.choices:
        continue

生产环境检查清单

在将 SiliconFlow 上线前，请逐项检查：

1. 带指数退避的重试逻辑

不要让一次临时的 429 击溃你的应用。用重试逻辑包裹调用：

import time
from openai import OpenAI, RateLimitError

client = OpenAI(
    api_key="YOUR_KEY",
    base_url="https://api.siliconflow.cn/v1",
)

def call_with_retry(messages, model, max_retries=3):
    for attempt in range(max_retries):
        try:
            return client.chat.completions.create(
                model=model,
                messages=messages,
            )
        except RateLimitError:
            wait = 2 ** attempt
            time.sleep(wait)
    raise Exception("Max retries exceeded")

2. 设置消费上限

SiliconFlow 在账户仪表板中允许你配置月度消费上限。设一个。失控的循环谁都会遇到。

3. 监控模型下线

SiliconFlow 会定期退役旧版模型。订阅其发版说明或每月检查一次。近期示例：Qwen/Qwen3-235B-A22B-Instruct-2507 于 2026-05-15 下线。

4. 使用正确的端点

• 中国大陆： https://api.siliconflow.cn/v1 — 延迟更低
• 海外： https://api.siliconflow.com/v1 — 非中国区域更优

5. 考虑路由层实现故障转移

如果 SiliconFlow 挂了，你的应用也会挂——除非有备用方案。我们通过 TheRouter 路由 SiliconFlow 请求，当 SiliconFlow 不可用时自动故障转移到其他供应商（DashScope、DeepSeek 直连）。配置只需改一行 base_url。

图片、视频和音频模型

SiliconFlow 不只是对话。平台还托管了多模态模型：

使用相同的 API Key 和认证方式。图片生成端点为 /v1/images/generations；音频为 /v1/audio/speech。

价格来源：siliconflow.com/pricing，2026-06-05 获取。

常见问题

SiliconFlow 是否兼容 OpenAI？

是的。SiliconFlow 暴露了 /v1/chat/completions、/v1/embeddings、/v1/images/generations 等标准 OpenAI 端点。Python 和 TypeScript OpenAI SDK 无需修改代码即可使用——只需设置 base_url。详见 SiliconFlow OpenAI SDK 集成。

SiliconFlow 价格与 DeepSeek/Qwen 直连对比如何？

取决于具体模型。DeepSeek V4 Pro 在 SiliconFlow 上收费 $1.74/$3.48 每百万 token（输入/输出），与 DeepSeek 直连 API 具有竞争力。Qwen 模型方面，SiliconFlow 部分规格可能比 DashScope 略便宜，因为 SiliconFlow 使用了自己的优化推理引擎。请随时查看最新价格——变动频繁。

可以在 SiliconFlow 上微调模型吗？

可以。SiliconFlow 提供托管式微调服务。上传训练数据，选择基础模型，SiliconFlow 负责 GPU 调度。价格因模型大小和训练时长而异。详见 SiliconFlow Products。

模型下线了怎么办？

SiliconFlow 在发版说明中提前公告下线计划。下线后的模型 ID 会返回 400 错误。解决方案：更新模型 ID 至推荐替代品。

SiliconFlow 会存储我的数据吗？

根据 SiliconFlow 的隐私政策，API 请求数据在处理后不会被存储。合规场景请查阅服务条款和隐私政策。

---

来源：SiliconFlow 快速上手（2026-06-05 获取），SiliconFlow 速率限制（2026-06-05 获取），SiliconFlow 定价（2026-06-05 获取），SiliconFlow 函数调用（2026-06-05 获取），SiliconFlow 发版说明（2026-06-05 获取）。