从API到内容平台：AI博客生成系统全栈实践

1. 为什么非要从"调API"升级到"内容平台"：动机与选型实录

大概在去年年底，我遇到了一个很实际的困扰：手里同时维护着两个技术博客，再加上给公司技术公众号供稿，每周至少需要产出三到四篇长文。靠人工硬写，灵感这东西又不稳定，碰上项目忙的时候，断更就成了常态。

当时市面上不是没有AI写作工具，但我把主流的那几家都试了一圈之后，彻底打消了付费订阅的念头。原因很简单：通用写作工具给的是通用模板，它不理解我的博客定位，也不知道我的读者想看什么。 每次生成的稿子都需要大改，改完一算时间成本，比自己从零写还高。

这时候我意识到，真正需要的不是"一个会写文章的网站"，而是"一整套围绕自己需求定制的内容生产流水线"——从输入灵感关键词开始，到生成标题、生成正文大纲、逐段扩写，再到格式化输出成Markdown文件，最后推送发布。这正好契合了"从API到内容平台"这个定位：底层是大模型API，上层是完整的全栈应用。

技术选型上，我一开始在几个大模型API服务商之间犹豫过。后来选了硅基流动，原因有三个：

1. 模型选择灵活。同一个API Key下面可以调用DeepSeek系列、Qwen系列、GLM系列等多个开源模型，不用为了换模型再注册别的平台。
2. 有免费额度。对于个人开发者验证想法来说，免费的额度足够完成整个Demo的开发和测试。
3. 接口兼容OpenAI格式。这意味着我之前积累的OpenAI SDK调用经验可以几乎零成本迁移过来。

这套方案做下来，我从输入一个主题到拿到一篇结构完整、可以直接发出去的初稿，时间从原来的几个小时压缩到了十分钟左右。整个过程我后面会拆开讲，包括后端怎么设计、API怎么调、提示词怎么写、踩了哪些坑。

2. 硅基流动API接入：注册、Key管理与第一次真正跑通

2.1 注册环节最容易出问题的几个小地方

硅基流动的注册流程本身不复杂，邮箱验证之后就能进控制台。但有两个细节值得提一下：

密码规则比较严。 注册的时候密码必须同时包含大小写字母和数字，长度也有要求。这个卡了我一下，因为平时习惯用统一密码格式，结果试了三次才通过。后来我干脆用密码管理器重新生成了一个，省得以后再折腾。

API Key的创建入口在控制台的"API密钥"页面。 创建之后，密钥只显示一次，刷新页面之后就再也看不到了。所以创建完第一件事就是复制保存到自己的密钥管理工具里。我习惯用环境变量的方式管理，而不是硬编码在代码里，后面会细说。

2.2 模型选型：不能只看参数大小

硅基流动平台上的模型列表很长，但实际用来做博客文章生成，我最终锁定的是DeepSeek系的中大杯模型。

有人可能会问，为什么不直接用参数最大的那个模型？这里涉及一个实操层面的权衡：参数量大的模型确实生成质量高，但响应速度慢、单次调用成本也高。 博客文章生成是一个需要多次调用的流程（标题、大纲、逐段扩写），单次推理时间的累加会直接影响用户体验。

我最终的模型选择逻辑是这样的：

这里有一个我实际测试的对比数据：用轻量模型生成标题，平均耗时3秒左右，质量完全够用；但用轻量模型生成长文，写到第三段就开始出现内容重复、逻辑断裂的问题。所以**"什么任务配什么模型"比"什么任务都用最强模型"更划算。**

2.3 API调用的核心参数：改哪些、怎么改

硅基流动的API兼容OpenAI格式，所以调用方式很标准，一个POST请求到/v1/chat/completions即可。我这里用的Python SDK，核心代码如下：

python复制from openai import OpenAI

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

response = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V3",
    messages=[
        {"role": "system", "content": "你是一位资深技术博客编辑..."},
        {"role": "user", "content": "为主题「xxx」生成10个吸引人的标题"}
    ],
    temperature=0.8,
    max_tokens=2048,
    top