> ## Documentation Index > Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt > Use this file to discover all available pages before exploring further. # Kimi K2.5 Text Generation > Moonshot AI's native multimodal flagship with a 256K context window and a Thinking mode. APIYI connects via Alibaba Cloud official transfer — 0.88× group pricing plus deposit bonuses brings effective cost below 80% of official. Kimi K2.5 is Moonshot AI's native multimodal flagship, released on January 27, 2026. It focuses on Visual Coding and autonomous Agent Swarm orchestration, with a 256K context window offered at no premium. APIYI integrates it via an **Alibaba Cloud official-transfer channel** for production-grade stability. The base group rate is **0.88× of official pricing**, and stacking deposit bonuses (from \$100 deposit → \$10 free and up) brings the **effective cost below 80% of official pricing**. **Kimi K2.5 is live on APIYI**: Alibaba Cloud official-transfer channel, OpenAI-compatible endpoint, model ID `kimi-k2.5`. Unlike Kimi's official site, **Thinking mode must be explicitly enabled via `enable_thinking: true`** in the request body — by default the model runs in Instant mode. ## Key Advantages 256K tokens at no premium — fit an entire mid-size codebase or long document in a single call. Enable deep reasoning with `enable_thinking: true` — built for complex planning, root-cause analysis, and agents. Understands images and code natively — excels at turning UI mockups, screenshots, and diagrams into runnable code. Routed through Alibaba Cloud's official-transfer channel — enterprise-grade SLA under high concurrency. ## Model Info | Parameter | Value | | - | - | | **Model ID** | `kimi-k2.5` | | **Context Window** | 256,000 tokens | | **Modes** | Instant / Thinking / Agent / Agent Swarm | | **Thinking Toggle** | `enable_thinking: true` in request body (default `false`) | | **Input** | Text + Image (native multimodal) | | **Output** | Text | | **Streaming** | ✅ Supported | | **Function Calling / Tool Use** | ✅ Supported | | **Channel** | Alibaba Cloud Official Transfer | Kimi's built-in `$web_search` tool is currently incompatible with Thinking mode. Per Moonshot's guidance, disable `enable_thinking` when you need the web\_search tool. This limitation matches the official platform. ## Pricing | Item | Official | APIYI Group (0.88×) | With Deposit Bonus (approx.) | | - | - | - | - | | Input | \$0.60 / 1M tokens | \$0.528 / 1M tokens | \~\$0.48 / 1M tokens | | Output | \$2.50 / 1M tokens | \$2.20 / 1M tokens | \~\$2.00 / 1M tokens | | Cache Hit (Input) | \$0.10 / 1M tokens | \$0.088 / 1M tokens | — | **Pricing notes**: APIYI uses a **0.88× multiplier** (88% of official list price) as the base group rate. Stacking onboarding / bulk deposit bonuses (e.g. \$100 deposit → \$10 free and up) brings the **effective cost below 80% of official**. See [Deposit Promotions](/en/faq/recharge-promotions) for details. ## How to Enable Thinking Mode The biggest difference from Kimi's official site is that APIYI defaults to Instant mode — you must explicitly enable Thinking via `enable_thinking` in the request body: | Use Case | `enable_thinking` | Notes | | - | - | - | | Daily chat / fast responses | `false` (default) | Instant mode, lowest latency | | Complex reasoning / code planning / RCA | `true` | Thinking mode, emits reasoning trace | | Agent with web\_search | `false` | Official limitation: web\_search vs thinking are mutually exclusive | ### cURL Example (Thinking enabled) ```bash theme={null} curl --location 'https://api.apiyi.com/v1/chat/completions' \ --header "Authorization: Bearer sk-xxxx" \ --header 'Content-Type: application/json' \ --data '{ "model": "kimi-k2.5", "messages": [ { "role": "system", "content": "You are a helpful assistant." }, { "role": "user", "content": "What is 1+1?" } ], "enable_thinking": true }' ``` ## How to Call ### Endpoint ``` https://api.apiyi.com/v1/chat/completions ``` ### Basic Usage (Instant Mode) ```bash cURL theme={null} curl -X POST "https://api.apiyi.com/v1/chat/completions" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "kimi-k2.5", "messages": [ {"role": "user", "content": "Introduce yourself in one sentence."} ] }' ``` ```python Python theme={null} from openai import OpenAI client = OpenAI( api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1" ) response = client.chat.completions.create( model="kimi-k2.5", messages=[ {"role": "user", "content": "Introduce yourself in one sentence."} ] ) print(response.choices[0].message.content) ``` ```javascript Node.js theme={null} import OpenAI from 'openai'; const client = new OpenAI({ apiKey: 'YOUR_API_KEY', baseURL: 'https://api.apiyi.com/v1' }); const response = await client.chat.completions.create({ model: 'kimi-k2.5', messages: [ { role: 'user', content: 'Introduce yourself in one sentence.' } ] }); console.log(response.choices[0].message.content); ``` ### Advanced Usage (Thinking Mode) ```python Python theme={null} from openai import OpenAI client = OpenAI( api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1" ) response = client.chat.completions.create( model="kimi-k2.5", messages=[ {"role": "system", "content": "You are a helpful assistant."}, {"role": "user", "content": "Analyze the time complexity of this code and suggest optimizations."} ], extra_body={ "enable_thinking": True } ) print(response.choices[0].message.content) ``` ```javascript Node.js theme={null} import OpenAI from 'openai'; const client = new OpenAI({ apiKey: 'YOUR_API_KEY', baseURL: 'https://api.apiyi.com/v1' }); const response = await client.chat.completions.create({ model: 'kimi-k2.5', messages: [ { role: 'system', content: 'You are a helpful assistant.' }, { role: 'user', content: 'Analyze the time complexity of this code and suggest optimizations.' } ], // @ts-ignore - custom field enable_thinking: true }); console.log(response.choices[0].message.content); ``` ### Streaming ```python theme={null} response = client.chat.completions.create( model="kimi-k2.5", messages=[{"role": "user", "content": "Write a short poem about spring."}], stream=True, extra_body={"enable_thinking": True} ) for chunk in response: if chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True) ``` ## Request Parameters | Name | Type | Required | Notes | | - | - | - | - | | `model` | string | Yes | Must be `kimi-k2.5` | | `messages` | array | Yes | Conversation messages | | `enable_thinking` | boolean | No | Enable Thinking mode; default `false` | | `stream` | boolean | No | Stream output | | `temperature` | number | No | Sampling temperature, 0–2 | | `max_tokens` | integer | No | Max output tokens | | `tools` | array | No | Function / tool list | ## Response Format ```json theme={null} { "id": "chatcmpl-xxxxxxxx", "object": "chat.completion", "created": 1706300000, "model": "kimi-k2.5", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "1+1 equals 2." }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 24, "completion_tokens": 12, "total_tokens": 36 } } ``` ## Best Practices 1. **Switch modes per task**: Leave Instant mode on for daily chat and short generations; set `enable_thinking: true` for complex reasoning, code review, and agent planning. 2. **Use the 256K context**: Fit a mid-size repo, full product docs, or long meeting transcripts in one call — at no premium. 3. **Multimodal visual coding**: Send UI screenshots / design mockups and let K2.5 "read → plan → code" in one shot. 4. **Stretch the savings**: Stack the \$100+ deposit bonus with the 0.88× group rate — effective cost drops below 80% of official. 5. **Mind the web\_search caveat**: Disable `enable_thinking` if you need Moonshot's built-in `$web_search` tool. ## FAQ Thinking mode is off by default. Make sure the request body includes `"enable_thinking": true`. With the OpenAI Python SDK, pass it inside `extra_body`; with the Node.js SDK you can pass it as a top-level field. Yes — it's the same upstream model, routed through Alibaba Cloud's official-transfer channel. The only difference is that Thinking mode is off by default and must be opted into via `enable_thinking`. When creating an API token in the APIYI console, assign it to a group that includes Kimi K2.5 — billing automatically applies the 0.88× multiplier. Combined with deposit bonuses, total cost drops further. See [Deposit Promotions](/en/faq/recharge-promotions). Yes. Pass standard OpenAI-style `tools` definitions. Note that the official `$web_search` built-in tool is mutually exclusive with Thinking mode — use them in separate calls. Thinking traces count as output tokens and are billed normally. Complex tasks may produce significantly more output tokens, so enable it only when you need the deeper reasoning. ## Related Resources Complete API usage guide Stack bonuses to drive the price down further Browse all available models and groups Client integration walkthroughs This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.