Skip to main content
POST
BaseURL 说明:默认 BaseURL 为 https://direct.evolink.ai,对文本模型支持更好,支持长连接;https://api.evolink.ai 是多模态主力地址,对文本模型作为备用地址使用。

授权

Authorization
string
header
必填

##所有接口均需要使用 Bearer Token 进行认证##

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

请求体

application/json
model
enum<string>
默认值:kimi-k3.1-pro
必填

要调用的模型:

三个模型的上下文窗口均为 1,048,576 tokens,均始终开启思考。

缓存写入时长(prompt_cache_options)仅 K3.1 系列支持,kimi-k3 不支持此参数。

可用选项:
kimi-k3.1-pro,
kimi-k3.1-pro-highspeed,
kimi-k3
messages
object[]
必填

对话消息。多轮对话需完整回传历史 assistant message。

Minimum array length: 1
max_completion_tokens
integer
默认值:131072

最大生成 Token 数,包含思考与最终回答;默认 131072,最大 1048576,同时受剩余上下文限制。

必填范围: 1 <= x <= 1048576
reasoning_effort
enum<string>
默认值:max

思考强度,模型始终思考。

  • kimi-k3.1-pro / kimi-k3.1-pro-highspeed:推荐 low / high / max,默认 max。兼容通用客户端:medium 按 high,xhigh 按 max,minimal / none 按 low 处理;none 不会关闭思考。
  • kimi-k3:仅支持 max(默认)。

提高强度通常增加推理 Token 和延迟,思考 Token 计入输出。

可用选项:
low,
high,
max,
medium,
xhigh,
minimal,
none
stream
boolean
默认值:false

是否使用 SSE 流式返回。

tools
object[]

函数工具或联网搜索工具。联网搜索使用 {"type":"web_search"}。

Maximum array length: 128
tool_choice

控制模型是否调用工具,或强制调用指定函数。

可用选项:
auto,
none,
required
prompt_cache_options
object

上下文缓存写入选项,仅 kimi-k3.1-pro / kimi-k3.1-pro-highspeed 支持,kimi-k3 不支持此参数。省略时默认自动写入 5m 缓存;写入、读取分别计费。

response_format
object

输出格式:text 为普通文本,json_object 返回 JSON 对象,json_schema 按指定的 JSON Schema 生成结构化结果。

max_tokens
integer
已弃用

兼容旧客户端的输出上限别名;新请求使用 max_completion_tokens,避免同时设置。

必填范围: 1 <= x <= 1048576
temperature
number
默认值:1

采样温度,由模型固定为 1,无需传入。kimi-k3.1-pro / kimi-k3.1-pro-highspeed 会自动忽略此字段;kimi-k3 传入不支持的取值将返回错误。

top_p
number
默认值:0.95

核采样阈值,由模型固定为 0.95,无需传入。kimi-k3.1-pro / kimi-k3.1-pro-highspeed 会自动忽略此字段;kimi-k3 传入不支持的取值将返回错误。

响应

对话补全响应;流式请求返回 SSE 事件流

id
string
object
string
示例:

"chat.completion"

created
integer
model
string
示例:

"kimi-k3.1-pro"

choices
object[]
usage
object