Kimi 配置与调用实用教程

Kimi 是由月之暗面推出的长文本大模型，支持高达 200 万字的上下文窗口，在长文档分析、深度推理等场景中表现突出。要将其集成到自己的工具或工作流中，需要完成一系列基础配置。以下步骤将带你从零开始完成环境搭建。

获取 API 密钥

访问官方开放平台，使用手机号注册并登录。进入控制台后，在“API Keys”页面创建一个新密钥。密钥仅创建时完整显示一次，务必及时复制并妥善保存。

注意：不要将密钥直接硬编码在代码中，尤其不要上传到公开仓库，避免泄漏造成财产损失。

配置开发环境

官方提供与 OpenAI 接口兼容的调用方式，可使用 Python 的 openai 库直接调用。首先安装依赖：

pip install openai

再将密钥设为环境变量。Linux/macOS 执行：

export MOONSHOT_API_KEY="你的密钥"

Windows 在终端中执行：

setx MOONSHOT_API_KEY "你的密钥"

设置完成后重启终端，或直接在代码中临时导入（仅用于测试，生产环境仍推荐环境变量）。

发起首次调用

新建一个 Python 脚本，写入以下示例：

import os from openai import OpenAI

client = OpenAI( api_key=os.environ.get("MOONSHOT_API_KEY"), base_url="https://api.moonshot.cn/v1", )

completion = client.chat.completions.create( model="moonshot-v1-8k", messages=[ {"role": "user", "content": "将以下英文翻译成中文：Hello, how are you?"} ], temperature=0.3, )

print(completion.choices[0].message.content)

运行脚本，若看到翻译结果，说明配置成功，此时可自行调整模型、温度等参数并融入实际项目。