模型配置

模型配置#

模型管理#

在使用 MoonBit Pilot 之前，你需要通过在 ~/.moonagent/models/models.json 创建一个配置文件来配置至少一个模型：

[
  {
    "name": "sonnet4",
    "description": "Claude Sonnet model for general tasks",
    "model_name": "anthropic/claude-sonnet-4",
    "model_type": "saas/openai",
    "base_url": "https://openrouter.ai/api/v1",    
    "is_reasoning": false,
    "input_price": 3.0,
    "output_price": 15.0,    
    "max_output_tokens": 8096,
    "context_window": 200000,
    "api_key": "your-api-key-here"
  },
  {
    "name": "k2",
    "description": "Moonshot Kimi model for cost-effective tasks",
    "model_name": "kimi-k2-0711-preview",
    "model_type": "saas/openai",
    "base_url": "https://api.moonshot.cn/v1",
    "is_reasoning": false,
    "input_price": 0.28,
    "output_price": 2.28,
    "max_output_tokens": 8096,
    "context_window": 120000,    
    "api_key": "your-api-key-here"
  }
]

配置参数#

下表描述了所有可用的配置参数：

参数

类型

必需

描述

name

字符串

是

模型的唯一标识符（用于通过 --model 参数引用）

description

字符串

否

模型的可读描述

model_name

字符串

是

API 提供商使用的实际模型标识符

model_type

字符串

是

API 接口类型（目前支持 “saas/openai”）

base_url

字符串

是

模型提供商的 API 端点 URL

is_reasoning

布尔值

是

是否为推理模型（影响 token 计数）

input_price

数字

否

每百万输入 token 的成本（美元）

output_price

数字

否

每百万输出 token 的成本（美元）

max_output_tokens

数字

否

模型可以输出的最大 token 数

context_window

数字

否

总上下文窗口大小（以 token 为单位）

api_key

字符串

是

您此提供商的 API 密钥

示例模型#

以上配置包括两个流行的模型：

Claude Sonnet 4 (sonnet4)#

  • 提供商：Anthropic via OpenRouter

  • 性能：高性能模型，质量卓越

  • 上下文窗口：200,000 token，适用于复杂任务

  • 定价：价格较高但质量卓越

  • 最适用于：复杂推理、大型代码库、高质量输出

Kimi K2 (k2)#

  • 提供商：Moonshot AI

  • 性能：性能良好，价格经济实惠

  • 上下文窗口：120,000 token

  • 定价：经济实惠的选择

  • 最适用于：日常开发任务，注重成本的项目

支持的模型#

MoonBit Pilot 通过各种 API 提供商支持以下模型：

模型

提供商

模型名称

基础 URL

备注

Kimi K2

Moonshot

kimi-k2-0711-preview

https://api.moonshot.cn/v1

性价比高，120k 上下文

DeepSeek V3

DeepSeek

deepseek-chat

https://api.deepseek.com/v1

高性能推理

DeepSeek R1

DeepSeek

deepseek-reasoner

https://api.deepseek.com/v1

高级推理模型

Claude Sonnet 4.0

Anthropic/OpenRouter

anthropic/claude-sonnet-4

https://openrouter.ai/api/v1

最新的高性能

Claude Sonnet 3.7

Anthropic/OpenRouter

anthropic/claude-3.7-sonnet

https://openrouter.ai/api/v1

最新的高性能

Claude Opus 4.0

Anthropic/OpenRouter

anthropic/claude-opus-4

https://openrouter.ai/api/v1

顶级质量

Gemini 2.5 Pro

Google/OpenRouter

google/gemini-2.5-pro

https://openrouter.ai/api/v1

Google 最新模型

GPT-4.1

OpenAI/OpenRouter

openai/gpt-4.1

https://openrouter.ai/api/v1

OpenAI’s advanced model

配置示例#

以下是一些支持的模型的配置示例：

DeepSeek V3#

{
  "name": "deepseek-v3",
  "description": "DeepSeek V3 for high performance reasoning",
  "model_name": "deepseek-chat",
  "model_type": "saas/openai",
  "base_url": "https://api.deepseek.com",
  "is_reasoning": false,
  "input_price": 0.25,
  "output_price": 0.85,
  "max_output_tokens": 8000,
  "context_window": 128000,
  "api_key": "your-deepseek-api-key"
}

Claude Sonnet 3.7#

{
  "name": "sonnet-3.7",
  "description": "Claude Sonnet 3.7 for balanced performance",
  "model_name": "anthropic/claude-3.7-sonnet",
  "model_type": "saas/openai",
  "base_url": "https://openrouter.ai/api/v1",
  "is_reasoning": false,
  "input_price": 3.0,
  "output_price": 15.0,
  "max_output_tokens": 8192,
  "context_window": 200000,
  "api_key": "your-openrouter-api-key"
}

Gemini 2.5 Pro#

{
  "name": "gemini-2.5-pro",
  "description": "Google Gemini 2.5 Pro",
  "model_name": "google/gemini-2.5-pro",
  "model_type": "saas/openai",
  "base_url": "https://openrouter.ai/api/v1",
  "is_reasoning": false,
  "input_price": 1.25,
  "output_price": 10,
  "max_output_tokens": 16192,
  "context_window": 1048576,
  "api_key": "your-openrouter-api-key"
}

获取 API 密钥#

要使用这些模型，你需要从各自的提供商处获取 API 密钥：

OpenRouter (用于 Claude Sonnet 4)#

  1. 访问 openrouter.ai

  2. 创建一个账户

  3. 导航到你的 API 密钥部分

  4. 生成一个新的 API 密钥

  5. 在 sonnet4 配置中替换 "your-api-key-here"

Moonshot (用于 Kimi K2)#

  1. 访问 platform.moonshot.cn

  2. 注册一个账户

  3. 在仪表板中访问你的 API 密钥

  4. 生成一个新的 API 密钥

  5. 在 k2 配置中替换 "your-api-key-here"

DeepSeek (用于 DeepSeek V3/R1)#

  1. 访问 platform.deepseek.com

  2. 创建一个账户

  3. 导航到 API 密钥部分

  4. 生成一个新的 API 密钥

  5. 在你的 DeepSeek 模型配置中替换 "your-deepseek-api-key"

用法#

配置好你的模型后，你就可以在 MoonBit Pilot 中使用它们了：

# 使用你配置中的第一个模型（默认）
moon pilot

# 指定一个特定的模型
moon pilot --model k2
moon pilot --model sonnet4
moon pilot --model deepseek-v3
moon pilot --model sonnet-3.5
moon pilot --model gemini-2.5-pro

你可以向配置中添加多个模型，并使用 --model 参数指定模型名称。

目录