硅基流动注册赠14元免费额度领取与使用指南

硅基流动的接口与 OpenAI 官方 SDK 兼容，只需要替换 base_url 与 api_key 就能复用现有代码。接口基地址形态为 https://api.siliconflow.cn/v1，对话补全路径为 /chat/completions。

一、准备密钥

在控制台创建 API Key 后，建议先写入环境变量，避免硬编码到代码里：

export SILICONFLOW_API_KEY="sk-你的密钥"

二、选择模型

模型名可在控制台「模型广场」或接口文档中查询，命名通常带厂商前缀，例如 Qwen/Qwen2.5-7B-Instruct、deepseek-ai/DeepSeek-V3。模型名写错时会返回模型不存在的报错，复制时注意大小写与斜杠。

三、用 curl 发起一次对话补全

下面是最小可用请求，关键参数包括 model（模型名）、messages（对话数组，role 取 system / user / assistant）、temperature（随机性，取值 0 到 2）、max_tokens（单次回复上限）与 stream（是否流式返回）：

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"}
    ],
    "temperature": 0.7,
    "max_tokens": 256,
    "stream": false
  }'

四、用 Python SDK 调用

安装官方 SDK 后，把 base_url 指向硅基流动即可，其余写法与调用 OpenAI 一致：

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": "你好，做个自我介绍"}],
    temperature=0.7,
    max_tokens=256,
)
print(resp.choices[0].message.content)

五、额度耗尽与限流的典型表现

• 余额不足：请求返回 403 类错误，提示余额或额度不足，控制台余额页可见赠额已扣完。
• 触发限流：返回 429，通常是并发数或每分钟请求数超过账号当前等级的上限，流式请求更容易在长输出时中断。
• 鉴权失败：返回 401，多为密钥填错、密钥已删除，或 Authorization 头缺少 Bearer 前缀。
• 模型不可用：返回模型不存在或无权限，需核对模型名是否在当前账号可选范围内。

排查顺序建议为：先确认密钥与环境变量是否生效，再核对 base_url 是否带 /v1、模型名是否准确，然后登录控制台查看余额与赠额有效期，最后再看并发与频率限制，必要时降低 max_tokens、关闭 stream 或增加重试间隔。赠额属于一次性额度，用完后需自行充值，是否长期可用请以控制台实际显示与官方公告为准。