From c944b2f0a6e160e78324c6b243bfb72ca361b8e1 Mon Sep 17 00:00:00 2001 From: Konstantin Krastev Date: Tue, 21 Jul 2026 02:17:09 +0300 Subject: [PATCH 1/2] docs(moonshot): update provider docs for model picker, refresh, and .ai/.cn base URL --- docs/providers/moonshot.md | 67 ++++++++++++++++++++++++++++++-------- 1 file changed, 54 insertions(+), 13 deletions(-) diff --git a/docs/providers/moonshot.md b/docs/providers/moonshot.md index 8478b853..796a2a5d 100644 --- a/docs/providers/moonshot.md +++ b/docs/providers/moonshot.md @@ -1,36 +1,72 @@ --- sidebar_label: Moonshot -description: Configure Moonshot AI's language models in Zoo Code. Access powerful AI models through Moonshot's OpenAI-compatible API. +description: Configure Moonshot AI's language models in Zoo Code. Access Kimi K2 series models through Moonshot's API with dynamic model picker and multi-region support. keywords: - moonshot - moonshot ai + - kimi k2 - zoo code - api provider - - openai compatible + - kimi-k2.5 + - kimi-k2.6 + - kimi-k2.7-code --- # Using Moonshot With Zoo Code -Zoo Code supports accessing models through the Moonshot AI API, which provides an OpenAI-compatible interface. +Zoo Code supports accessing models through the Moonshot AI API, featuring the Kimi K2 series of language models with dynamic model discovery and multi-region endpoint support. -**Website:** [https://platform.moonshot.cn/](https://platform.moonshot.cn/) +**Website:** [https://platform.moonshot.ai/](https://platform.moonshot.ai/) (Global) | [https://platform.moonshot.cn/](https://platform.moonshot.cn/) (China) --- ## Getting an API Key -1. **Sign Up/Sign In:** Go to the [Moonshot Platform](https://platform.moonshot.cn/). Create an account or sign in. -2. **Navigate to API Keys:** Find your API keys in the API keys section of the platform. +1. **Sign Up/Sign In:** Go to the [Moonshot Platform](https://platform.moonshot.ai/) (or [platform.moonshot.cn](https://platform.moonshot.cn/) for China-based access). Create an account or sign in. +2. **Navigate to API Keys:** Find your API keys in the API keys section of the platform console. 3. **Create a Key:** Create a new API key. Give your key a descriptive name (e.g., "Zoo Code"). -4. **Copy the Key:** **Important:** Copy the API key *immediately*. You will not be able to see it again. Store it securely. +4. **Copy the Key:** **Important:** Copy the API key _immediately_. You will not be able to see it again. Store it securely. + +--- + +## Base URL Selection + +Moonshot provides two API endpoints depending on your region. Select the appropriate one in the **Moonshot Base URL** dropdown in Zoo Code settings: + +| Endpoint | Base URL | Use Case | +| ----------------- | ---------------------------- | ----------------------- | +| `api.moonshot.ai` | `https://api.moonshot.ai/v1` | Global access (default) | +| `api.moonshot.cn` | `https://api.moonshot.cn/v1` | China-based access | + +Choose the endpoint that matches your account region for the best connectivity and latency. --- ## Available Models -Zoo Code supports all models available through the Moonshot API. +Zoo Code supports the following Moonshot models. The model list is fetched dynamically from the Moonshot API using the **Refresh Models** button in settings. + +| Model | Context | Max Output | Multimodal | Key Features | +| -------------------------- | ------- | ---------- | -------------------- | ----------------------------------------------------- | +| `kimi-k2-0905-preview` | 256K | 16K | Text only | Default model. Agentic coding, prompt caching | +| `kimi-k2-thinking` | 256K | 16K | Text only | Reasoning model with deep thinking support | +| `kimi-k2-turbo-preview` | 256K | 32K | Text only | High-speed variant (up to 100 tokens/s) | +| `kimi-k2.5` | 256K | 16K | Text + Image + Video | Multimodal with thinking mode support | +| `kimi-k2.6` | 256K | 16K | Text + Image + Video | Improved coding, self-correction | +| `kimi-k2.7-code` | 256K | 16K | Text + Image + Video | Best for coding tasks, long-context programming | +| `kimi-k2.7-code-highspeed` | 256K | 16K | Text + Image + Video | High-speed coding (~180 tokens/s, up to 260 tokens/s) | + +### Refreshing the Model List + +The models available in Zoo Code are fetched live from the Moonshot API: + +1. Enter your API key in the settings. +2. Click the **Refresh Models** button to fetch the current model list. +3. The model dropdown will populate with all available models from your selected endpoint. + +**Note:** An API key is required to fetch the model list. The Refresh Models button will show an error if no key is configured. -For the complete, up-to-date model list, see [Moonshot's API documentation](https://platform.moonshot.cn/docs). +For the complete, up-to-date model list and pricing, see [Moonshot's API documentation](https://platform.moonshot.ai/docs). --- @@ -38,12 +74,17 @@ For the complete, up-to-date model list, see [Moonshot's API documentation](http 1. **Open Zoo Code Settings:** Click the gear icon () in the Zoo Code panel. 2. **Select Provider:** Choose "Moonshot" from the "API Provider" dropdown. -3. **Enter API Key:** Paste your Moonshot API key into the "Moonshot API Key" field. -4. **Select Model:** Choose your desired model from the "Model" dropdown. +3. **Select Base URL:** Choose the appropriate endpoint (`api.moonshot.ai` or `api.moonshot.cn`) from the "Moonshot Base URL" dropdown. +4. **Enter API Key:** Paste your Moonshot API key into the "Moonshot API Key" field. +5. **Refresh Models:** Click the **Refresh Models** button to fetch the available models. +6. **Select Model:** Choose your desired model from the "Model" dropdown. --- ## Tips and Notes -* **OpenAI-Compatible:** Moonshot uses an OpenAI-compatible API format, making it easy to integrate with Zoo Code. -* **Pricing:** Refer to the Moonshot platform for details on model costs and pricing. +- **Multi-Region Support:** Use `api.moonshot.ai` for global access and `api.moonshot.cn` for China-based accounts. +- **Dynamic Model Picker:** Models are fetched from the Moonshot API, so you always have access to the latest models without updating Zoo Code. +- **Prompt Caching:** Most Kimi K2 models support prompt caching, reducing costs for repeated prefix tokens. +- **Max Tokens:** Moonshot requires the `max_tokens` parameter. The default is set based on the selected model's capabilities. +- **Pricing:** Refer to the [Moonshot platform](https://platform.moonshot.ai/) for details on model costs and pricing. From c09a7d27872abe1475a0d8eded8466c1d249e86c Mon Sep 17 00:00:00 2001 From: Konstantin Krastev Date: Tue, 21 Jul 2026 02:52:45 +0300 Subject: [PATCH 2/2] =?UTF-8?q?docs(moonshot):=20fix=20review=20feedback?= =?UTF-8?q?=20=E2=80=94=20entrypoint=20label,=20button=20disabled=20state,?= =?UTF-8?q?=20add=20kimi-k2-0711-preview?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/providers/moonshot.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/providers/moonshot.md b/docs/providers/moonshot.md index 796a2a5d..9e8c3ff4 100644 --- a/docs/providers/moonshot.md +++ b/docs/providers/moonshot.md @@ -31,7 +31,7 @@ Zoo Code supports accessing models through the Moonshot AI API, featuring the Ki ## Base URL Selection -Moonshot provides two API endpoints depending on your region. Select the appropriate one in the **Moonshot Base URL** dropdown in Zoo Code settings: +Moonshot provides two API endpoints depending on your region. Select the appropriate one in the **Moonshot Entrypoint** dropdown in Zoo Code settings: | Endpoint | Base URL | Use Case | | ----------------- | ---------------------------- | ----------------------- | @@ -48,6 +48,7 @@ Zoo Code supports the following Moonshot models. The model list is fetched dynam | Model | Context | Max Output | Multimodal | Key Features | | -------------------------- | ------- | ---------- | -------------------- | ----------------------------------------------------- | +| `kimi-k2-0711-preview` | 128K | 32K | Text only | MoE model, 1T total parameters, prompt caching | | `kimi-k2-0905-preview` | 256K | 16K | Text only | Default model. Agentic coding, prompt caching | | `kimi-k2-thinking` | 256K | 16K | Text only | Reasoning model with deep thinking support | | `kimi-k2-turbo-preview` | 256K | 32K | Text only | High-speed variant (up to 100 tokens/s) | @@ -64,7 +65,7 @@ The models available in Zoo Code are fetched live from the Moonshot API: 2. Click the **Refresh Models** button to fetch the current model list. 3. The model dropdown will populate with all available models from your selected endpoint. -**Note:** An API key is required to fetch the model list. The Refresh Models button will show an error if no key is configured. +**Note:** An API key is required to fetch the model list. The Refresh Models button is disabled until an API key is entered. For the complete, up-to-date model list and pricing, see [Moonshot's API documentation](https://platform.moonshot.ai/docs). @@ -74,7 +75,7 @@ For the complete, up-to-date model list and pricing, see [Moonshot's API documen 1. **Open Zoo Code Settings:** Click the gear icon () in the Zoo Code panel. 2. **Select Provider:** Choose "Moonshot" from the "API Provider" dropdown. -3. **Select Base URL:** Choose the appropriate endpoint (`api.moonshot.ai` or `api.moonshot.cn`) from the "Moonshot Base URL" dropdown. +3. **Select Base URL:** Choose the appropriate endpoint (`api.moonshot.ai` or `api.moonshot.cn`) from the "Moonshot Entrypoint" dropdown. 4. **Enter API Key:** Paste your Moonshot API key into the "Moonshot API Key" field. 5. **Refresh Models:** Click the **Refresh Models** button to fetch the available models. 6. **Select Model:** Choose your desired model from the "Model" dropdown.