Skip to content

Build and run agents you can see, understand and trust.

feat(moonshot): add Kimi K3 model support in MoonshotChatModel class (#2141)

qbc999f64db8126
diff --git a/src/agentscope/model/_moonshot/_model.py b/src/agentscope/model/_moonshot/_model.py
index 0ab3dca07..c4dba08e1 100644
--- a/src/agentscope/model/_moonshot/_model.py
+++ b/src/agentscope/model/_moonshot/_model.py
@@ -46,6 +46,16 @@ class MoonshotChatModel(ChatModelBase):
),
)
+ reasoning_effort: Literal["low", "high", "max"] | None = Field(
+ default=None,
+ title="Reasoning Effort",
+ description=(
+ "The reasoning effort level for kimi-k3. "
+ "Supports 'low', 'high', and 'max' "
+ "(default 'max')."
+ ),
+ )
+
temperature: float | None = Field(
default=None,
title="Temperature",
@@ -173,8 +183,13 @@ class MoonshotChatModel(ChatModelBase):
"stream": self.stream,
}
+ is_k3 = model_name == "kimi-k3"
+
if self.parameters.max_tokens is not None:
- kwargs["max_tokens"] = self.parameters.max_tokens
+ if is_k3:
+ kwargs["max_completion_tokens"] = self.parameters.max_tokens
+ else:
+ kwargs["max_tokens"] = self.parameters.max_tokens
if self.parameters.temperature is not None:
kwargs["temperature"] = self.parameters.temperature
@@ -184,12 +199,19 @@ class MoonshotChatModel(ChatModelBase):
kwargs.update(generate_kwargs)
- thinking_type = (
- "enabled" if self.parameters.thinking_enable else "disabled"
- )
- kwargs.setdefault("extra_body", {})
- kwargs["extra_body"].setdefault("thinking", {})
- kwargs["extra_body"]["thinking"].setdefault("type", thinking_type)
+ if is_k3:
+ if self.parameters.reasoning_effort is not None:
+ kwargs["reasoning_effort"] = self.parameters.reasoning_effort
+ else:
+ thinking_type = (
+ "enabled" if self.parameters.thinking_enable else "disabled"
+ )
+ kwargs.setdefault("extra_body", {})
+ kwargs["extra_body"].setdefault("thinking", {})
+ kwargs["extra_body"]["thinking"].setdefault(
+ "type",
+ thinking_type,
+ )
fmt_tools, fmt_tool_choice = self._format_tools(tools, tool_choice)
diff --git a/src/agentscope/model/_moonshot/_models/kimi-k2.5.yaml b/src/agentscope/model/_moonshot/_models/kimi-k2.5.yaml
index bc2e2739a..237ad103e 100644
--- a/src/agentscope/model/_moonshot/_models/kimi-k2.5.yaml
+++ b/src/agentscope/model/_moonshot/_models/kimi-k2.5.yaml
@@ -20,3 +20,5 @@ output_size: 65536
parameter_overrides:
max_tokens:
maximum: 65536
+ reasoning_effort:
+ hidden: true
diff --git a/src/agentscope/model/_moonshot/_models/kimi-k2.6.yaml b/src/agentscope/model/_moonshot/_models/kimi-k2.6.yaml
index 53c58bd9e..3a34a0685 100644
--- a/src/agentscope/model/_moonshot/_models/kimi-k2.6.yaml
+++ b/src/agentscope/model/_moonshot/_models/kimi-k2.6.yaml
@@ -25,3 +25,5 @@ output_size: 32768
parameter_overrides:
max_tokens:
maximum: 32768
+ reasoning_effort:
+ hidden: true
diff --git a/src/agentscope/model/_moonshot/_models/kimi-k3.yaml b/src/agentscope/model/_moonshot/_models/kimi-k3.yaml
new file mode 100644
index 000000000..71dd5cf1f
--- /dev/null
+++ b/src/agentscope/model/_moonshot/_models/kimi-k3.yaml
@@ -0,0 +1,29 @@
+name: kimi-k3
+label: Kimi K3
+status: active
+
+input_types:
+ - text/plain
+ - application/x-thinking
+ - image/jpeg
+ - image/png
+ - image/gif
+ - image/webp
+ - video/mp4
+ - video/mpeg
+ - video/quicktime
+ - video/avi
+ - video/webm
+
+output_types:
+ - text/plain
+ - application/x-thinking
+
+context_size: 1048576
+output_size: 1048576
+
+parameter_overrides:
+ max_tokens:
+ maximum: 1048576
+ thinking_enable:
+ hidden: true
diff --git a/src/agentscope/model/_moonshot/_models/moonshot-v1-128k.yaml b/src/agentscope/model/_moonshot/_models/moonshot-v1-128k.yaml
index 7bfa9a9fb..6f3e112fe 100644
--- a/src/agentscope/model/_moonshot/_models/moonshot-v1-128k.yaml
+++ b/src/agentscope/model/_moonshot/_models/moonshot-v1-128k.yaml
@@ -14,3 +14,5 @@ output_size: 131072
parameter_overrides:
max_tokens:
maximum: 131072
+ reasoning_effort:
+ hidden: true
diff --git a/src/agentscope/model/_moonshot/_models/moonshot-v1-32k.yaml b/src/agentscope/model/_moonshot/_models/moonshot-v1-32k.yaml
index b6ffdd288..3ae99026b 100644
--- a/src/agentscope/model/_moonshot/_models/moonshot-v1-32k.yaml
+++ b/src/agentscope/model/_moonshot/_models/moonshot-v1-32k.yaml
@@ -14,3 +14,5 @@ output_size: 32768
parameter_overrides:
max_tokens:
maximum: 32768
+ reasoning_effort:
+ hidden: true
diff --git a/src/agentscope/model/_moonshot/_models/moonshot-v1-8k.yaml b/src/agentscope/model/_moonshot/_models/moonshot-v1-8k.yaml
index 488cd8d74..8e4149e11 100644
--- a/src/agentscope/model/_moonshot/_models/moonshot-v1-8k.yaml
+++ b/src/agentscope/model/_moonshot/_models/moonshot-v1-8k.yaml
@@ -14,3 +14,5 @@ output_size: 8192
parameter_overrides:
max_tokens:
maximum: 8192
+ reasoning_effort:
+ hidden: true