快速开始 - Kimi API 开放平台

快速开始 - Kimi API 开放平台

从创建 API Key 到完成第一次 Kimi API 调用。

访问网站
我的收藏200 次访问更新于 a month ago反馈
快速开始 - Kimi API 开放平台 screenshot

详细介绍

简介

Kimi API 开放平台提供了与 Kimi 大模型交互的能力,并兼容 OpenAI API 格式。开发者只需准备 API Key、选择模型,并配置 base_url,即可通过 HTTP API、Python SDK 或 Node.js SDK 发起调用。本页面为「快速开始」指南,涵盖从创建 API Key 到完成第一次 Kimi API 调用的完整流程,并简要介绍平台更多可用功能。

Kimi K3 旗舰模型已正式发布,它是 Kimi 迄今能力最强的模型,支持 1M token 上下文与视觉理解,适合 Codex、Claude Code 等编程 Agent 场景,以及知识工作与深度推理场景。

开始使用

1. 获取 API Key

访问 Kimi API 开放平台,登录后进入 API Keys 页面创建并复制 API Key。请妥善保管你的 API Key,不要泄露给他人,也不要直接硬编码在代码中,建议使用环境变量保存:

复制代码
export MOONSHOT_API_KEY="你的_KIMI_API_KEY"

2. 选择模型

作为快速开始入口,建议优先从 Kimi K3 开始;也可根据场景选择其他模型:

  • Kimi K3:面向长程编程与端到端知识工作的旗舰模型,2.8 万亿参数、1M token 上下文,综合智能达到领先水平。
  • Kimi K2.7 Code:面向代码场景的 Coding 模型,支持 256K 上下文窗口、文本/图片/视频输入和思考模式;如需更高输出速度,可选择 kimi-k2.7-code-highspeed
  • Kimi K2.6:综合能力强,支持 256K 上下文窗口、文本/图片/视频输入、思考与非思考模式,适合通用对话、Agent 任务、视觉理解和复杂推理。

不确定如何选择时,默认从 kimi-k3 开始;主要做代码生成、修改或编程 Agent 且追求更高输出速度,可选择 kimi-k2.7-code-highspeed

3. 选择调用方式

Kimi API 兼容 OpenAI API 格式,可选接入方式包括:

  • HTTP API:标准 REST API,适合任意语言或自研服务端接入。
  • OpenAI Python SDK:适合脚本、后端服务、数据处理与原型验证。
  • OpenAI Node.js SDK:适合 Web 服务、前端工程链路和 Node.js 应用。
  • 开发工作台:无需写代码,快速测试提示词、模型效果和业务样例。

4. 发起第一次调用

以 Kimi K3 模型为例,使用 OpenAI Python SDK 的示例:

python 复制代码
import os
from openai import OpenAI

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

completion = client.chat.completions.create(
    model="kimi-k3",
    messages=[
        {"role": "system", "content": "你是 Kimi,由 Moonshot AI 提供的人工智能助手,你更擅长中文和英文的对话。你会为用户提供安全,有帮助,准确的回答。同时,你会拒绝一切涉及恐怖主义,种族歧视,黄色暴力等问题的回答。Moonshot AI 为专有名词,不可翻译成其他语言。"},
        {"role": "user", "content": "你好,我叫李雷,1+1等于多少?"}
    ]
)

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

运行前需准备:Python 3.8+ 或 Node.js 18+,OpenAI SDK 1.0.0+,以及有效的 API Key。成功运行后将输出类似「你好,李雷!1+1 等于 2。」的回复(因模型不确定性可能不完全一致)。

探索更多功能

  • 流式输出:启用 stream,让回复边生成边返回,适合聊天、代码生成和长文本输出。
  • 多轮对话:通过维护 messages 列表实现上下文记忆。
  • 多模态输入:Kimi K3、K2.7 Code 和 K2.6 均支持文本、图片与视频输入;较大视频或多次引用的图片/视频建议用文件上传,图片不超 4K、视频不超 1080p。
  • 工具调用:让模型调用外部函数或 API,实现 Agent 任务、联网搜索和复杂工作流。
  • JSON Mode:强制模型输出合法 JSON,方便结构化数据提取。
  • 思考模式:使用思考能力处理复杂推理、多步工具调用和 Agent 任务。

适用场景

  • 快速接入 Kimi 大模型能力,进行通用对话、复杂推理与视觉理解。
  • 编程 Agent 场景(如 Codex、Claude Code)及端到端知识工作(Kimi K3)。
  • 代码生成与修改、追求高速输出的代码场景(Kimi K2.7 Code 高速版)。
  • 需要多模态输入、流式输出或结构化 JSON 返回的业务集成。

相关资源

  • Kimi K3 模型、Kimi K2.7 Code 模型、Kimi K2.6 模型详细文档与最佳实践
  • 模型列表:查看当前可用模型名称和说明
  • Kimi 开发者交流群:提供建议、反馈与案例分享