文库科学常识小课堂
### 1. 申请Kimi API Key
#### 1.1 登录开发者平台
访问Moonshot AI开发者平台（[https://platform.moonshot.cn/console/api-keys](https://platform.moonshot.cn/console/api-keys)），首次登录可获赠15元测试金额，适合学习用途。
#### 1.2 创建API Key
- 进入左侧「API Key管理」页面，点击「新建API Key」。
- 注意：密钥仅显示一次，需立即保存。每个组织最多保留5个Key，且不可共享或暴露在客户端代码中，否则可能被禁用。
- 填写Key名称（可自定义），项目选择默认的「default」即可。
#### 1.3 查看用量限制
免费用户需关注以下参数：
- **并发数**：同一时间仅处理1条请求
- **RPM**：每分钟最多3次请求
- **TPM**：每分钟交互Token上限32,000
- **TPD**：每日Token总量限制
---
### 2. Python调用Kimi API实战
#### 2.1 基础配置
参考官方文档（[https://platform.moonshot.cn/docs](https://platform.moonshot.cn/docs)），单轮对话示例代码如下：
```python
from openai import OpenAI
client = OpenAI(
api_key="sk-ja9eqqluh1ircym8ushn3osbjna1etx0rfjzfspd1ocq06qs",
base_url="https://api.moonshot.cn/v1"
)
history = [{
"role": "system",
"content": "你是Kimi，由Moonshot AI提供的人工智能助手，擅长中英文对话。需遵守安全准则，拒绝敏感话题。"
}]
def chat(query, history):
history.append({"role": "user", "content": query})
completion = client.chat.completions.create(
model="moonshot-v1-8k",
messages=history,
temperature=0.3
)
result = completion.choices[0].message.content
history.append({"role": "assistant", "content": result})
return result
print(chat("你是谁？", history))
print(chat("1+1等于几？", history))
```
#### 2.2 代码解析
1. **初始化客户端**：通过`OpenAI`类加载API Key和基础URL。
2. **对话历史管理**：
- `system`角色设定助手行为准则
- 用户输入以`user`角色追加到历史记录
- 助手回复以`assistant`角色保存
3. **参数说明**：
- `model`：指定"moonshot-v1-8k"模型
- `temperature`：控制生成随机性（建议0.3保持稳定性）
---
### 3. 关键注意事项
- **密钥安全**：泄露可能导致服务中断，建议使用环境变量存储Key。
- **用量监控**：免费版存在严格频次限制，复杂任务需分批处理。
- **模型选择**：8K上下文版本适合短文本交互，长文本需升级更高规格模型。