kimi简单使用
什么是Kimi API
官网：https://platform.moonshot.cn/
Kimi API 并不是一个我所熟知的广泛通用的术语。我的推测是，你可能想问的是关于 API 的一些基础知识。API（Application Programming Interface，应用程序编程接口）是一种软件架构概念，它定义了软件组件之间如何交互的规则和定义。简单来说，API 允许不同的软件程序之间进行通信和数据交换，而不需要了解彼此的内部实现细节。例如，许多网络应用程序通过提供 API 接口，让其他开发者能够访问其功能或数据，像社交媒体平台的 API 可能允许开发者获取用户信息、发布内容等操作。
API怎么获取
控制台：https://platform.moonshot.cn/console/account
-
查看官方文档：大多数提供 API 服务的机构或公司会在其官方网站上提供详细的 API 文档，文档中会介绍如何注册获取 API 密钥（API Key）、API 的使用方法、可调用的接口功能等。
-
注册账号：很多 API 需要你先在对应的平台上注册账号，然后通过账号申请获取 API Key，这个 Key 就是你调用 API 时验证身份的凭证。
-
遵守使用限制和规则：获取 API 后，你需要仔细阅读其使用条款，因为不同的 API 可能有请求频率限制、数据使用范围等规定，违规使用可能会导致你的访问权限被限制甚至被封禁。
curl是什么？
curl 是一个非常流行的命令行工具和库，用于在互联网上进行数据传输。它可以与各种网络协议（如 HTTP、HTTPS、FTP 等）进行交互，功能强大且灵活。开发者和系统管理员经常使用它来测试网络连接、与 API 交互、下载或上传文件等。例如，你可以用 curl 向一个 API 发送请求，获取返回的数据，或者从一个网页上抓取内容。
测试工具测试curl
curl -X POST https://api.moonshot.cn/v1/chat/completions \-H "Content-Type: application/json" \-H "Authorization: Bearer $MOONSHOT_API_KEY" \-d '{"model": "moonshot-v1-8k","messages": [{"role": "system", "content": "wmcodes是一个资源丰富的公众号"},{"role": "user", "content": "你好，我想找个资源公众号？"}],"temperature": 0.3}'
先分析格式
-X : 请求方式+路径
-H : 请求头
-d : 请求体(json格式)
ApiPost 工具测试
请求方式：POST
API接口: https://api.jikemoonshot.cn/v1/chat/completions
请求头:
Content-Type : application/jsonAuthorization: your-key
请求体：
{"model": "moonshot-v1-8k","messages": [{"role": "system", "content": "wmcodes是一个资源丰富的公众号"},{"role": "user", "content": "你好，我想找个资源公众号？"}],"temperature": 0.3}
其中：
-
model模型：moonshot-v1-8k: 它是一个长度为 8k 的模型，适用于生成短文本。
moonshot-v1-32k: 它是一个长度为 32k 的模型，适用于生成长文本。
moonshot-v1-128k: 它是一个长度为 128k 的模型，适用于生成超长文本。
moonshot-v1-8k-vision-preview: 它是一个长度为 8k 的 Vision 视觉模型，能够理解图片内容，输出文本。
moonshot-v1-32k-vision-preview: 它是一个长度为 32k 的 Vision 视觉模型，能够理解图片内容，输出文本。
moonshot-v1-128k-vision-preview: 它是一个长度为 128k 的 Vision 视觉模型，能够理解图片内容，输出文本。
-
system角色：用于设置对话的背景、指导 AI 的行为和风格、限制内容范围等。它对用户不可见，但对 AI 的回答逻辑至关重要。 -
user角色：用于表示用户输入的内容，是对话的主体部分，直接影响 AI 的回答。
-
temperature精准度：这个值是0-1的，越高值那么消耗的算力越高，同时返回的数据也越精准
ApiPost 数据填写
对非 stream 格式的，返回类似如下：
{"id": "cmpl-04ea926191a14749b7f2c7a48a68abc6","object": "chat.completion","created": 1698999496,"model": "moonshot-v1-8k","choices": [{"index": 0,"message": {"role": "assistant","content": " 你好，李雷！1+1等于2。如果你有其他问题，请随时提问！"},"finish_reason": "stop"}],"usage": {"prompt_tokens": 19,"completion_tokens": 21,"total_tokens": 40}}
对 stream 格式的，返回类似如下：
data: {"id":"cmpl-1305b94c570f447fbde3180560736287","object":"chat.completion.chunk","created":1698999575,"model":"moonshot-v1-8k","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}data: {"id":"cmpl-1305b94c570f447fbde3180560736287","object":"chat.completion.chunk","created":1698999575,"model":"moonshot-v1-8k","choices":[{"index":0,"delta":{"content":"你好"},"finish_reason":null}]}...data: {"id":"cmpl-1305b94c570f447fbde3180560736287","object":"chat.completion.chunk","created":1698999575,"model":"moonshot-v1-8k","choices":[{"index":0,"delta":{"content":"。"},"finish_reason":null}]}data: {"id":"cmpl-1305b94c570f447fbde3180560736287","object":"chat.completion.chunk","created":1698999575,"model":"moonshot-v1-8k","choices":[{"index":0,"delta":{},"finish_reason":"stop","usage":{"prompt_tokens":19,"completion_tokens":13,"total_tokens":32}}]}data: [DONE]
项目构建过程
<dependency><groupId>cn.hutool</groupId><artifactId>hutool-all</artifactId> <version>5.8.25</version>
</dependency>
<dependency><groupId>com.squareup.okhttp3</groupId><artifactId>okhttp</artifactId> <version>3.14.8</version>
</dependency>
<dependency><groupId>com.squareup.okhttp3</groupId><artifactId>okhttp-sse</artifactId> <version>4.10.0</version>
</dependency>项目构建过程
创建 枚举类
package com.jkglxt.www.enums;
public enum RoleEnum { system, user, assistant;
}创建 消息类
package com.jkglxt.www.entity;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
@NoArgsConstructor
@AllArgsConstructor
@Data
@Builder
public class Message {private String role;private String content;
}创建 控制器
package com.jkglxt.www.controller;import cn.hutool.core.collection.CollUtil;
import com.jkglxt.www.entity.Message;
import com.jkglxt.www.enums.RoleEnum;
import okhttp3.*;import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.concurrent.TimeUnit;@RestController
public class ChatController {@PostMapping("/chat")public String chat() {OkHttpClient client = new OkHttpClient().newBuilder().connectTimeout(30, TimeUnit.SECONDS).readTimeout(30, TimeUnit.SECONDS).build();try {// 设置密钥--在kimi个人中心新建密钥即可获得String apiKey = "your_api_key";// moonshot开发的访问apiString apiUrl = "https://api.moonshot.cn/v1/chat/completions";// 三种访问标准 标准不同收费不同：moonshot-v1-8k、moonshot-v1-32k、moonshot-v1-128kString model = "moonshot-v1-8k";// 设置请求头Map<String, String> header = new HashMap<String, String>();header.put("Authorization", "Bearer " + apiKey);header.put("Content-Type", "application/json");// 设置提问信息List<Message> messages = CollUtil.newArrayList(// new Message(RoleEnum.system.name(), "你是kimi AI"),new Message(RoleEnum.user.name(), "什么是java 20字介绍一下"));String requestBody = new cn.hutool.json.JSONObject().putOpt("model", model).putOpt("messages", messages).toString();Request request = new Request.Builder().url(apiUrl).headers(Headers.of(header)).method("POST", okhttp3.RequestBody.create(MediaType.parse("application/json"),requestBody)).build();try (Response response = client.newCall(request).execute()) {String str=checkResponse(response);System.out.println("答复:"+str);return str;}} catch (Exception e) {throw new RuntimeException("Unknown err", e);}}private String checkResponse(Response response) {if (response.isSuccessful()) {if(response.body()==null){throw new RuntimeException("Response body is null");}else{try(ResponseBody body = response.body()){return body.string();}catch (Exception e){throw new RuntimeException("Error reading response body",e);}}} else if(response.code()==401) {throw new RuntimeException("Unauthorized");} else if (response.code() == 400) {throw new RuntimeException("Bad request");} else if (response.code() == 429) {throw new RuntimeException("Too many requests");} else{throw new RuntimeException("Error response code: "+response.code());}}
}
* Thanks you *
如果觉得文章内容不错，随手帮忙点个赞、在看、转发一下，如果想第一时间收到推送，也可以给我个星标⭐～谢谢你看我的文章。
* 往期推荐 *
Wrod 也可以添加代码快啦！！快看有哪种你是会的吧！
Linux | 零基础Ubuntu搭建JDK
Maven | 站在初学者的角度配置与项目创建(新手必学会)
Spring Ai | 极简代码从零带你一起走进AI项目(中英)
Open Ai | 从零搭建属于你的Ai项目(中英结合)
MongoDB | 零基础学习与Springboot整合ODM实现增删改查(附源码)
Openfeign | 只传递城市代码，即可获取该地域实时的天气数据(免费的天气API)
API接口到底是什么
Redis | 缓存技术对后端的重要性，你知道多少？
Mongodb | 基于Springboot开发综合社交网络应用的项目案例(中英)
谈谈模块化设计在单体架构中的应用
彻底讲清楚 单体架构、集群架构、分布式架构及扩展架构
为什么还在使用单体架构
2025年Java路线一条龙服务
2025年健康新趋势：科技与生活方式的融合
感谢阅读 | 更多内容尽在公棕号 WMCode | CSDN@小Mie不吃饭
