硅基流动免费API注册领16元额度和免费模型接入指南

硅基流动的接口完全兼容 OpenAI 规范，已有 OpenAI SDK 的项目只需替换 base_url 与 API Key 即可运行。

接口地址与模型获取

对话补全的接口基址为 https://api.siliconflow.cn/v1，路径为 /chat/completions。可用模型名请在控制台「模型广场」或模型列表接口中查询，例如各类开源对话模型均以完整的模型标识填写到 model 字段，不要凭记忆手写。

一次对话补全调用

下面的 curl 命令可直接复制执行，替换其中的密钥与模型名即可：

curl https://api.siliconflow.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SILICONFLOW_API_KEY" \
  -d '{
    "model": "your-model-name",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ],
    "temperature": 0.7,
    "max_tokens": 512,
    "stream": false
  }'

关键参数说明：model 为控制台中的模型标识；messages 是对话数组，按 system、user、assistant 顺序组织；temperature 控制随机性，取值 0 到 1 左右；max_tokens 限制输出长度；stream 设为 true 时返回流式分片，适合聊天界面。

在 Python 中可用 OpenAI SDK 直接对接，先设置环境变量再调用：

export SILICONFLOW_API_KEY="sk-xxxxxxxxxxxxxxxx"

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="your-model-name",
    messages=[{"role": "user", "content": "写一句产品口号"}],
    temperature=0.7,
    max_tokens=256
)
print(resp.choices[0].message.content)

额度耗尽与限流的排查顺序

• 先看返回码。出现 401 多为密钥错误或未带 Authorization 头；403 常见于模型无权限或未实名；404 多为模型名写错或接口路径拼错。
• 再查余额与代金券。余额不足时通常返回 402 或提示额度用尽，此时到控制台费用中心确认代金券是否过期、是否已被消耗完。
• 最后看速率限制。返回 429 表示触发限流，免费模型与低等级账户的并发较低，建议降低并发、加指数退避重试，或缩短 max_tokens 与上下文长度。
• 排查网络与地址。请求超时先确认是否误写成官网域名，接口基址应带 /v1；公司网络或代理环境需放行对应域名。