爆肝了几篇DeepSeek的文章，发现很多人不知道API和官方APP有什么区别，或者说不知道API有什么用。

其实使用API可是实现很多DIY的功能，比如：

  • 在苹果手机上，通过API将大模型和Siri进行结合，实现语音交互；
  • 和备忘录结合，实现将对话内容保存到备忘录中；
  • 和微信结合，将生成的消息发送到微信上；
  • 和智能家居结合，实现更多的智能场景。
  • 等等

今天一文让你搞明白！

一、什么是API

API的全称是：Application Programming Interface，即应用程序编程接口。是一组允许不同软件应用程序之间进行通信、交互和数据交换的规则、协议和工具。

用大白话理解就是：

假如你是一个老板，API就是你的员工，你只需要告诉API要做什么，API就会根据它自己的执行流程，给你返回结果。当然，你给API不同的工具（参数），它会给你返回不同的结果。

API通常由三部分组成：

  • URL
  • API-Key
  • 参数
  • 返回结果

简单描述下如何使用：将API-Key和参数发送到指定的URL，然后返回对应的结果

二、如何使用API

目前DeepSeek的API官网处于瘫痪状态：

DeepSeek API是什么，和官方APP有什么不同？

下面使用Siliconflow为例，介绍一下如何使用API。

按照第一节说的，API通常由三部分组成：URL、API-Key、参数、返回结果。

2.1 URL

一般在服务提供商的文档中，会提供API的调用方式，其中就包含了URL，如下图所示：

DeepSeek API是什么，和官方APP有什么不同？

在上图中，https://api.siliconflow.cn/v1/chat/completions就是API对应的URL

2.2 API-Key

服务提供商一般会有一个创建API密钥的功能，如下图所示：

DeepSeek API是什么，和官方APP有什么不同？

sk开头的一串字母就是API-Key。

2.3 参数

这一部分同样会在API文档里提供说明，如下图所示：

DeepSeek API是什么，和官方APP有什么不同？DeepSeek API是什么，和官方APP有什么不同？

Body部分就是可以自定义的参数，比如：

  • model：模型名
  • frequency_penalty：用于控制生成文本中重复词语的频率
  • max_tokens：生成的最大token数
  • stream：是否是流式输出（流式：生成一点，返回一点。非流式：全部生成完再返回）
  • temperature：生成回答时的随机程度
  • 等等

2.4 返回结果

API返回结果通常是json格式，在API官网文档中同样会给出说明，如下图所示：

DeepSeek API是什么，和官方APP有什么不同？

Response就是API返回的格式，比如：

  • choices：返回的生成的数据，列表格式，列表中的每一项表示一条生成结果，每一项包含了message和finish_reason。其中finish_reason表示是否生成完毕，message表示当前这条消息的结果，在message中，role表示角色，比如助力、系统、用户等等，content是返回的具体内容，reasoning_content表示思维链的内容
  • id：当前返回结果的id
  • model：是哪个模型生成的结果
  • 等等

三、举个例子

其实官方已经给了使用例子了，包含了不同语言或工具的，如cURL、Python、JavaScript、Go、Java，照着抄就行了：

DeepSeek API是什么，和官方APP有什么不同？

比如，用cURL调用API，可以直接把上面的命令复制一下，将<token>替换为API-Key，粘贴到命令行，如下图所示：

DeepSeek API是什么，和官方APP有什么不同？

上面的可能和普通用户距离比较远，那么来看一下在手机上就能操作的例子（苹果手机）。

打开「快捷指令」，并添加一个快捷指令，然后添加一个「获取URL内容」，就可以设置各种URL、API-Key、参数了：

DeepSeek API是什么，和官方APP有什么不同？

如果需要完整的快捷指令，可以在公众号发送关键词获取，关键词可以在文末找到

在请求体中，会有文本、数字、数组、词典、布尔值这几个类型，如下图所示：

DeepSeek API是什么，和官方APP有什么不同？

下面以官方API文档的例子为例，列举下不同字段对应什么类型：

DeepSeek API是什么，和官方APP有什么不同？

在上图中：

  • "model": "deepseek-ai/DeepSeek-V3"是文本类型
  • "messages": [ ... ]是数组类型
  • { ... } 是词典类型
  • "stream": false是布尔值类型
  • "temperature": 0.7是数字类型

根据官网文档中的类型进行请求体的设置即可。

四、和官方APP相比有什么区别

官方APP实际上也是在API的基础上，封装了许多其他的功能，比如用户登陆、联网搜索、创建对话等功能，好处是开箱即用，普通用户没有学习成本。

但是如果想自定义一些功能，而官方APP又没有提供，那么我们可以直接使用API进行DIY。

比如：

  • 在苹果手机上，通过API将大模型和Siri进行结合，实现语音交互；
  • 和备忘录结合，实现将对话内容保存到备忘录中；
  • 和微信结合，将生成的消息发送到微信上；
  • 和智能家居结合，实现更多的智能场景。
  • 等等

使用API能够实现的功能完全取决于你的脑洞有多大！

来源：Jack Bytes