Kimi K3.1 Pro API 快速入门：模型 ID、base_url 与 OpenAI SDK 调用

一句话结论

接入 Kimi K3.1 Pro 时使用模型 ID kimi-k3.1-pro、base_url=https://api.moonshot.ai/v1 和 OpenAI SDK 的 Chat Completions 接口；该旗舰模型需至少成功充值 $1 才能解锁，累计充值金额决定账户层级及并发、RPM、TPM、TPD 限制。

适用场景

• 适合的任务：将 Kimi K3.1 Pro 接入 Python 服务、脚本或支持 OpenAI 兼容接口的客户端，并核对账户解锁条件。

• 不适合的任务：推理档位、视觉输入、上下文缓存、工具调用或模型效果评测；这些主题不在本稿范围内。

• 适用的模型版本：旗舰模型 kimi-k3.1-pro；官方页面另列高速变体 kimi-k3.1-pro-highspeed，其价格和可用性需单独核对。

• 适用的客户端、Agent 或 API：Python 3.9+、openai>=1.0、Kimi API Chat Completions，以及使用同一 OpenAI 兼容端点的客户端。

• 推荐的推理档位和参数：本稿不覆盖推理配置；需要设置 reasoning_effort 时应查阅官方 Reasoning Effort 文档。

可直接使用的内容

先安装 OpenAI Python SDK，并将 API Key 放入环境变量：

python3 -m pip install --upgrade 'openai>=1.0'
export MOONSHOT_API_KEY='YOUR_API_KEY'

最小可运行调用：

import os

from openai import OpenAI

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

completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=[
        {"role": "user", "content": "用一句话介绍 Kimi K3.1 Pro。"}
    ],
)

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

配置对应关系：

测试或工作流步骤

1. 在 Kimi API Platform 创建 API Key，并写入 MOONSHOT_API_KEY；不要把 Key 写入代码仓库。

2. 确认账户已完成至少 $1 的成功充值，使 Kimi K3.1 Pro 解锁。

3. 安装 Python 3.9+ 与 openai>=1.0，按上方示例固定 base_url 和模型 ID。

4. 发送一条最小 Chat Completions 请求，检查 completion.choices[0].message.content 是否有返回内容。

5. 在上线前根据累计充值对应的账户层级核对并发、RPM、TPM、TPD 限额，并在自己的服务中记录请求失败和限流响应。

原始证据与数据

• 官方页面的 Get started 部分要求 Python 3.9+ 和 OpenAI SDK，并给出 python3 -m pip install --upgrade 'openai>=1.0'。

• 官方初始化示例使用 api_key=os.environ["MOONSHOT_API_KEY"] 与 base_url="https://api.moonshot.ai/v1"。

• 官方 Basic call 示例使用 client.chat.completions.create，模型字段为 "kimi-k3.1-pro"；页面同时列出高速变体 kimi-k3.1-pro-highspeed。

• 官方 Access requirements 写明 Kimi K3.1 Pro 是旗舰模型，成功充值最低金额为 $1；累计充值金额决定账户层级和速率限制，包括并发、RPM、TPM、TPD，并链接到 Recharge and Rate Limits。

• 页面结构化数据的 dateModified 为 2026-10-23T18:17:30.027Z，但页面没有发布日期字段，因此发布日期记为“未注明”。

• 页面中的代码块是官方配置示例；本稿未使用 API Key 发起本地请求，没有本地实测延迟、成功率或返回内容数据。

适用边界

• $1 是官方页面给出的旗舰模型解锁最低充值金额，不是模型调用价格，也不代表所有账户都获得相同的并发或速率上限。

• 账户层级和限流值由累计充值及平台规则决定；实际限制应以账户控制台和 Recharge and Rate Limits 当前内容为准。

• kimi-k3.1-pro-highspeed 是官方页面提到的另一模型 ID；本文没有把它的速度、价格或效果外推到旗舰模型。

• 本文只记录基础 API 配置，不据此判断模型能力，不把官方页面中未填充的占位 benchmark（如 [xx.x%]）当作数字，也不替代推理、视觉、缓存和工具调用专文。

复现说明

1. 打开原文并确认页面标题为 Kimi K3.1 Pro，记录采集日期、模型 ID、Base URL、SDK 版本要求和充值限制。

2. 在本地 Python 3.9+ 环境安装 openai>=1.0，设置 MOONSHOT_API_KEY，运行“可直接使用的内容”中的脚本。

3. 使用真实 API Key 前，先确认账户已成功充值至少 $1；再记录 HTTP 状态、响应内容、模型 ID 和限流信息。

4. 本次复现仅完成官方页面配置核验，未提交真实 API 请求，因此不能声称已有本地调用结果。