硅基流动 API 怎么用？注册到首次调用全流程

一个 API Key 就能调用 DeepSeek、Qwen、GLM、Kimi 等 100 多个主流模型，这就是硅基流动（SiliconFlow）对国内开发者的核心价值。它的接口兼容 OpenAI SDK，所以接入成本极低：注册账号、完成实名认证、创建密钥、把 base_url 换成官方地址，三步就能跑通第一次调用。本文按 2026 年 9 月 18 日抓取的官方文档与模型价格页，走一遍从注册到首次调用的完整流程，并把官方价格、分时段计费和常见报错一次讲清。

前置准备：注册与实名认证

打开 SiliconFlow 官网，进入 SiliconCloud 平台，右上角登录，官方目前支持短信登录和邮箱登录两种方式（来源：快速上手文档）。两点提前说清：

1. 新用户注册赠送的免费额度可以直接体验大部分模型，具体规则详见站内的 DeepSeek V4 Pro 免费使用指南 与免费额度专题。
2. 免费额度用完后需要充值，往账户充值前要先完成实名认证，这是国内模型服务平台的合规要求，认证入口与所需材料以官方实名认证说明为准。

注册后可以先在平台的体验中心（playground）网页里选模型直接对话，不写一行代码就能确认模型效果，再决定接不接 API。

先建立一个量级认知：100+ 模型与官方规模数据

动手前先对齐平台现状。按官方 模型广场首页的公开口径，硅基流动目前提供「1 个 API，100+ 主流模型」，官方标注的平台规模是超 1000 万用户、13000 家企业客户，并自称按 2025 年的词元年吞吐量计为中国最大的独立词元供应平台。这些数字来自官方页面、会随官方更新变化，引用时以官网实时显示为准。

在架模型覆盖也很广：DeepSeek、Qwen、GLM（Z-ai）、Kimi（Moonshot）、腾讯混元（Hunyuan）、美团 LongCat、阶跃 Stepfun、百度、字节 Seed、BAAI 嵌入模型、inclusionAI 等系列都能找到，文本、生图、语音、视频、嵌入、重排序都有独立接口。也就是说，如果你在做检索增强类项目，同一个 Key 就能同时调 chat 和 embeddings，不用再单独找一家向量模型服务商。

第一步：创建 API 密钥

登录后进入 API 密钥页面，点「新建 API 密钥」生成一串 Key。建议每个项目单独建一个 Key，方便后续分别管理和吊销。Key 只在创建时完整显示一次，记得立即保存到本地环境变量或密钥管理工具里，不要写进代码仓库。

第二步：在模型广场选模型

模型广场 里能看到所有在架模型的详情、价格和速率上限。以 2026 年 9 月为准，主流系列都在架：

1. DeepSeek 系列：V4-Pro、V4-Flash、V3.2 等新一代模型，旗舰 V4-Pro 为 1.6T 参数 MoE 架构。
2. Qwen 系列：Qwen3.8-27B、Qwen3.6-35B-A3B、Qwen3.5-122B-A10B 等，含视觉理解版本。
3. GLM 系列：GLM-5.3、GLM-5.2 等智谱旗舰，1M 上下文，适合长程智能体任务。
4. Kimi、MiniMax、混元等：Kimi-K2.7-Code 面向代码任务，MiniMax-M2.5 偏 Agent 场景。

价格直接标在模型卡片上，单位是每百万 tokens（M Tokens），分输入价、输出价、缓存命中价三档。按官方价格页 2026 年 9 月显示的数据：DeepSeek-V3.2 输入 ¥4、输出 ¥6、缓存 ¥0.40；GLM-5.3 输入 ¥8、输出 ¥28、缓存 ¥2.00。选型经验是先用便宜的小参数模型调通流程，再换旗舰模型跑正式任务。

第三步：用 OpenAI SDK 完成首次调用

硅基流动的大语言模型兼容 OpenAI 接口。确认本机 Python 3.7.1 以上，装好官方库：

pip install --upgrade openai

然后把 base_url 指向硅基流动，用官方文档示例的代码直接跑：

from openai import OpenAI

client = OpenAI(
    api_key="你的API密钥",
    base_url="https://api.siliconflow.cn/v1"
)

response = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V3.2",
    messages=[
        {"role": "user", "content": "用一句话介绍你自己"}
    ],
    stream=True
)

for chunk in response:
    if not chunk.choices:
        continue
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

不想用 Python 的话，标准 OpenAI 格式的 curl 请求也能直接调，接口地址是 https://api.siliconflow.cn/v1/chat/completions，把 Key 放进 Authorization 请求头即可。终端里打印出模型的流式回复，就说明整条链路通了。官方快速上手文档的示例里还演示了用 reasoning_content 字段读取推理过程，接推理模型时可以直接照搬。

除了对话，还有一整套多模态接口

很多人只知道硅基流动能调文本模型，其实平台的能力矩阵覆盖了生成式 AI 的主要方向，每个方向都有独立的 API 手册页：

1. 文本系列：对话补全（OpenAI 格式和 Anthropic 格式都有）、文本嵌入（embeddings）、重排序（rerank）。
2. 图像系列：文生图接口，在架模型包含 Z-Image 系列和百度的 ERNIE-Image-Turbo 等，其中 Z-Image-Turbo 输出价约 ¥0.10/张。
3. 语音系列：文本转语音、语音转文本、参考音频上传。
4. 视频系列：视频生成任务提交与状态查询。
5. 批量处理：batch 任务接口，适合离线跑大批量推理。

计费逻辑与官方价格对照表

计费模型很简单：按各模型标注的单价乘以实际消耗的 tokens 数，输入和输出分别计价，价格差通常在一倍以上。下面这张表整理自官方模型价格页 2026 年 9 月 18 日显示的数据，注意官方价格实时同步，购买前务必以价格页为准：

两个容易被忽略的细节。第一是有模型按分时段计价：DeepSeek-V4-Flash 在 2 点至 8 点时段更便宜（输入 ¥1.50、输出 ¥4.50），Hunyuan-A13B-Instruct 在 9 点至 18 点时段更贵（输入 ¥1.00、输出 ¥4.00），跑批量任务时错峰能省钱。第二是价格并非一成不变：本文首发当天（9 月 14 日）记录的 DeepSeek-V3.2 还是输入 ¥2、输出 ¥3，复查 9 月 18 日官网价格页已调整为输入 ¥4、输出 ¥6，所以别拿旧截图报价，一律以官网实时价格为准。

三个省量的实用建议：

1. 调试阶段用小模型，确认 prompt 没问题后再切旗舰模型，避免用 GLM-5.3 这种价格跑调试轮次。
2. 有上下文缓存的场景优先利用缓存计价，重复前缀的多次调用成本会明显下降。
3. 在平台的财务页面绑定余额告警，流式长对话的输出 tokens 增长比直觉快得多。

关于新用户的免费额度和各模型免费档规则，属于入口和省钱话题，站内免费额度专题有完整展开，本文聚焦调用流程就不再重复。

常见报错速查

接入阶段最容易卡住的是这几类报错，按现象对号入座即可：

官方还专门维护了一份 API 请求错误排查文档，拿不准错误码时先去那里对照。