阅读原文：为原型注入 AI 能力

一、本章核心学习目标

• 掌握 API 基础概念，理解 AI 能力接入的核心逻辑

• 学会将静态原型接入真实 AI 能力，从演示壳子变成能解决真实问题的应用

• 实战：完成文本生成、图像理解、图像生成三类 AI 能力的接入

• 学会模型选型方法，找到适合自己产品的高性价比 AI 服务

二、API 基础：AI 能力接入的核心

要把 AI 能力接入到原型里，核心是理解 API（应用程序编程接口），它本质就是一个标准化的通信规则：

你按要求的格式发请求，对方按格式返回结果

2.1 核心概念

概念	通俗解释
API Key	你的通行证 + 钱包钥匙，用来身份验证和计费，别人拿到就能替你调用接口花钱
Endpoint	接口的具体地址，告诉服务器你要调用哪个功能，比如文本生成、图像生成的地址不一样
请求	你发给 AI 的内容，比如要生成的文案、图片描述
响应	AI 返回的结果，比如生成好的文案、图片链接
错误处理	调用失败时的排查，比如 Key 错了、余额不足、参数不对

2.2 API 安全注意事项

API Key 直接关联你的账户和费用，绝对要注意：

1. 不要分享到群聊、公开论坛，不要截图泄露

2. 不要硬编码到代码里提交到公开 Git 仓库

3. 怀疑泄露立刻更换新 Key

练习阶段可以临时把 Key 给 AI IDE，正式项目要放到配置文件里，不要暴露

三、接入文本生成 API：让原型会写文案

我们以 DeepSeek 文本模型为例，把原型里的文案生成按钮变成真实可用的功能，核心流程非常简单：

拿到 API Key → 找到官方调用示例 → 把 Key + 示例丢给 AI IDE，让它帮你集成到按钮上

3.1 DeepSeek 接入实战

1. 注册 DeepSeek 账号，创建 API Key，充值少量费用（足够测试）

2. 找到官方的 API 调用示例（比如 curl 示例）

3. 把 Key 和示例一起发给 AI IDE，用提示词告诉它要做什么：

   参考这个调用方法，帮我支持文案生成功能，基于商品信息点击后生成对应抖音电商文案，支持多种风格。
   api key：你的Key
   api 请求参考：官方的curl示例
   

4. AI 会自动帮你把接口集成到原型里，点击按钮就能真实调用大模型生成文案了

3.2 其他文本模型选型

大部分文本模型都提供OpenAI 兼容接口，切换起来只需要改三个地方：基础 URL、API Key、模型名，非常方便：

MiniMax 集成

• 特点：支持超长上下文，高性价比，适合长文档处理

• 接入方式和 DeepSeek 完全一致，只需要替换对应的地址和 Key 即可

四、接入图像转文字 API：让原型看懂图片

如果你的原型需要处理用户上传的图片，比如电商里的商品图，就需要用到视觉语言模型（VLM），它能看懂图片里的内容，提取信息、生成描述。

4.1 Qwen3 VL 实战

我们用硅基流动（SiliconFlow）这个模型聚合平台来接入，它集成了很多主流模型，不用分别注册不同平台：

1. 注册 SiliconFlow 账号，创建 API Key

2. 选择 Qwen3-VL 模型，找到它的调用示例

3. 把 Key 和示例发给 AI IDE，让它帮你集成：

   • 上传商品图片后，自动调用 VLM 识别图片内容

   • 基于图片信息生成商品卖点、标题

• 这个模型的能力：图像理解、OCR 提取文字、视觉问答，中文理解表现优异，适合国内业务场景

五、接入图像生成 API：让原型会做图

除了理解图片，还可以接入文生图、图生图能力，让原型自动生成商品主图、营销海报。

5.1 核心接入流程

和前面的能力一样，流程完全通用：

1. 选择你要的图像服务，拿到 API Key

2. 找到官方的调用示例

3. 把 Key + 示例丢给 AI IDE，让它帮你接到原型的生成图片按钮上

5.2 常见图像服务选型

服务	特点	适用场景
Seedream 即梦	国产文生图模型，中文理解好，性价比高	通用电商配图、海报生成
Recraft	设计向模型，擅长矢量插画、品牌素材，设计精度高	营销设计、品牌插画
Qwen Image（通义万相）	阿里云的图像模型，支持文生图、图生图、局部编辑，中文优化好	电商主图、图片编辑、营销素材

提示：先跑通一个基础的文生图功能，再根据你的业务场景，替换成更适合的模型就行，接入逻辑都是一样的。

六、如何选到当前更好的 AI 模型

AI 模型更新很快，不用纠结哪个最好，用这两个平台就能快速选型：

6.1 LMArena

• 地址：https://lmarena.ai/

• 作用：模型竞技场，用户投票选更好的回答，投票越多分数越高，代表真实使用场景里更稳

• 用法：看排行榜，选你要的场景（通用 / 编程 / 视觉），挑 Top3 里你能访问、价格能接受的

6.2 Artificial Analysis

• 地址：https://artificialanalysis.ai/

• 作用：把模型的效果、价格、速度放在一起对比，相当于选型参数表

• 用法：找到你要的模型类别，看质量 + 价格 + 延迟，选综合性价比最高的

不要凭感觉选，用同一组输入测试 2-3 个模型，结合榜单和价格做决定。

七、本章核心总结

接入 AI 能力其实没那么复杂，不用把 API 想的太吓人：

1. API 本质就是标准化的通信：你发请求，它回结果，不用关心背后的技术细节

2. 所有 AI 能力的接入流程都是通用的：拿 Key→找示例→让 AI IDE 帮你集成，不管是文本、图像还是其他能力，都是这个流程

3. 大部分模型都是 OpenAI 兼容的，切换模型只需要改几个参数，非常方便

4. 你只需要关心业务逻辑，底层的调用、错误处理这些繁琐的事，交给 SDK 和 AI IDE 就行

八、本章作业

完成一次完整的 AI 能力接入闭环：

1. 选择一个 AI 服务（文本生成 / 文生图 / 图生图），接入到你之前做的电商工作台原型里

2. 实现前后端交互，让按钮能真实调用 AI 能力，返回结果

3. 测试功能，确保能正常生成内容

4. 思考题：思考怎么把这些 AI 能力组合起来，做更有意思的业务功能