Skip to content

kimi.md

Latest commit

 

History

History
100 lines (78 loc) · 1.92 KB

kimi.md

File metadata and controls

100 lines (78 loc) · 1.92 KB

Kimi Code

Reverse-engineered, undocumented API. May change without notice.

Overview

  • Protocol: REST (plain JSON)
  • Base URL: https://api.kimi.com/coding/v1
  • Auth provider: https://auth.kimi.com (OAuth 2.0)
  • Client ID: 17e5f671-d194-4dfb-9706-5516cb48c098
  • Token store: ~/.kimi/credentials/kimi-code.json

Endpoints

GET /usages

Returns overall usage and at least one windowed quota.

Headers

Header Required Value
Authorization yes Bearer <access_token>
Accept yes application/json

Example Response

{
  "usage": {
    "limit": "100",
    "remaining": "74",
    "resetTime": "2026-02-11T17:32:50.757941Z"
  },
  "limits": [
    {
      "window": {
        "duration": 300,
        "timeUnit": "TIME_UNIT_MINUTE"
      },
      "detail": {
        "limit": "100",
        "remaining": "85",
        "resetTime": "2026-02-07T12:32:50.757941Z"
      }
    }
  ],
  "user": {
    "membership": {
      "level": "LEVEL_INTERMEDIATE"
    }
  }
}

POST https://auth.kimi.com/api/oauth/token

Refreshes access_token using refresh_token.

Request

application/x-www-form-urlencoded

client_id=17e5f671-d194-4dfb-9706-5516cb48c098
grant_type=refresh_token
refresh_token=<refresh_token>

Response

{
  "access_token": "<new_access_token>",
  "refresh_token": "<new_refresh_token>",
  "expires_in": 3600,
  "scope": "kimi-code",
  "token_type": "Bearer"
}

Authentication File

~/.kimi/credentials/kimi-code.json

{
  "access_token": "<token>",
  "refresh_token": "<token>",
  "expires_at": 1769861835.261056,
  "scope": "kimi-code",
  "token_type": "Bearer"
}

Notes

  • The plugin refreshes tokens when near expiry (5-minute buffer).
  • If refresh is rejected (401/403), user must run kimi login again.
  • limits[0].window.duration=300 and TIME_UNIT_MINUTE maps to the 5-hour session window.