Kimi Android App API 逆向文档

kimi_3.1.0.apk · com.moonshot.kimichat · 3.1.0 (371) · 260 APIs · 69 services · 909 messages · 158 enums

SHA-256：dfec71074faf75e5ae21c488538ff3a28a726ed2da33b609ee6a5953bcacc27f

Git revision：11d1ceb9b5e653e5da0a014dde3cddc81fff41bc

接口索引

共 69 个服务、260 个接口（⚡ = 服务端流式，需按帧解析）。

• 社区对话 · moment.v1.ChatService：CreateChatV2、GetLastChatV2、GetOriginalMessageCount、GetRawShareChatV2、ReChat
• 社区-评论 · moment.v1.CommentService：CreateComment、DeleteComment、ListComments、ListSubComments、VoteComment
• 社区-举报 · moment.v1.ComplaintService：CreateComplaint
• 社区配置 · moment.v1.ConfigService：GetConfig
• 社区-收藏 · moment.v1.FavoriteService：CreateFavorite、DeleteFavorite
• 社区信息流 · moment.v1.FeedService：GetFeed、ListFeeds、ListFollowUnread、MarkReadForFollow
• 社区-关注 · moment.v1.FollowService：ListFollows、ModifyBlock、ModifyFollow
• 社区-话题 · moment.v1.HashtagService：GetHashtag、ListHashtags、RecommendHashtags
• 社区-兴趣 · moment.v1.InterestService：ReportSelections、SubmitSelections
• 社区-动态 · moment.v1.MomentService：CreateMoment、DeleteMoment、GetChatShareCard、ListMomentAskKimiQuestions、ListSimilarMoments、VoteMoment
• 社区-屏蔽 · moment.v1.MuteService：AppendMuteReasons、ListMuteReasons、Mute、UnMute
• 社区通知 · moment.v1.NotificationService：GetReminderStatus、ListNotification、ListReminders、MarkRead、MarkReadForReminder
• 社区搜索 · moment.v1.SearchService：ListHotHashtagsInSearch、SearchHashtags、SearchMoments、SearchUsers、SuggestSearchQuery
• 社区-上传 · moment.v1.UploadService：CreateFile、GeneratePresignedURL
• 社区用户 · moment.v1.UserService：GetMe、GetUserProfile、ListMentionableBots
• 对话 · kimi.gateway.chat.v1.ChatService：BatchDeleteChats、CancelChat、Chat⚡、ChatFromCase⚡、ContinueChat⚡、CreateChatFromShare、CreateChatShare、GetChat、GetChatShare、GetChatShareMessage、GetChatShareScreenshot、GetMessage、GetMessageRecommendPrompts、GetToolBlock、GetUnreadChats、ListChats、ListMessages、MarkChatAsRead、MessageSpeech⚡、ProcessAskUserResult、RegenerateMessage⚡、ReplayChatShareStream⚡、ReplyInteraction、ResumeChat⚡、ShareChatToCommunity、SubscribeMessageStream⚡、UpdateChat、VoteMessage
• 对话分享 · kimi.gateway.chat.v1.ChatShareService：GetChatShareDocx
• Kimi+ · kimi.gateway.chat.v1.KimiPlusService：ListKimiPlus、ListPinnedKimiPlus
• 提示词 · kimi.gateway.chat.v1.PromptService：GetEnhancedPrompts
• IM 群聊 · kimi.gateway.im.v1.IMService：CreateInvitation、CreateRoom、DeleteRoom、GetRoom、GetRoomByInvitation、GetThread、InviteMembers、ListMembers、ListMessages、ListRooms、ListTypingMembers、RemoveMember、SendMessage、SetMemberRole、UpdateRoom
• 账号认证 · account.gateway.v1.AuthService：BindPhone、ConfirmLoginQRCode、LoginWithOneClick、LoginWithSMS、LoginWithThirdParty、Logout、RefreshToken、ScanLoginQRCode
• 账号设备 · account.gateway.v1.DeviceService：RegisterDevice
• 短信验证码 · account.gateway.v1.SMSService：ListCountries、SendVerifyCode
• 青少年模式 · kimi.gateway.account.v1.MinorModeService：BindGuardian、GetMinorMode、ResetPasscode、UnbindGuardian、UpdateMinorMode、VerifyGuardianPhone、VerifyGuardianReset
• 账号安全 · kimi.gateway.account.v1.SecurityService：BindPhone、BindThirdAccount、DeactivateAccount、ListThirdAccounts、RebindPhone、SendVerifyCode、UnbindThirdAccount、VerifyCurrentPhone
• 用户 · kimi.gateway.account.v1.UserService：GetCurrentUser、ListWorkspaces、SwitchWorkspace、UpdateProfile
• Claw 文件 · kimi.gateway.claw.v1.ClawFileService：ListFiles
• 上下文 · kimi.gateway.context.v1.ContextService：GetGoal、UpdateGoal
• 文档转换 · kimi.gateway.converter.v1.ConverterService：ExportDocument、GetExportDocumentJob
• 文件 · kimi.gateway.file.v1.FileService：GetFileParseProgress
• 存储 · kimi.gateway.storage.v1.StorageService：GetUserStorageQuota
• 应用发布 · kimi.gateway.app.v1.AppService：ListVersions、PreviewApp、PublishApp、UnpublishApp
• App 支持 · kimi.gateway.appsupport.v1.AppSupportService：ScanQRCode
• 产物分享 · kimi.gateway.artifact.v1.ArtifactService：ShareArtifact
• Claw 机器人 · kimi.gateway.claw.v1.ClawService：CreateBot、CreateModelAPIKey、DeleteBot、ListBots
• Claw 技能 · kimi.gateway.claw.v1.ClawSkillService：DeleteRemoteSkill、InstallSkillToRemote、ListClawSkills、ListRemoteSkills
• 配置 · kimi.gateway.config.v1.ConfigService：GetAvailableModels、GetConfig、GetPrecheckConfig
• 设备 · kimi.gateway.device.v1.DeviceService：CountDevices、DeleteDevice、ListDevices
• 实验 · kimi.gateway.experiment.v1.ExperimentService：GetExperiments
• 信息流 · kimi.gateway.feed.v1.FeedService：ListFeeds
• 凭证签发 · kimi.gateway.issuance.v1.IssuanceService：GetCredential
• MCP OAuth · kimi.gateway.mcp.v1.MCPOAuthService：CreateMCPServerAuthorization、GetMCPServerAuthorization
• MCP · kimi.gateway.mcp.v1.MCPService：SetMCPUserSettingStatus
• OKC/产物 · kimi.gateway.mcp.v1.OKCService：GetCitationsByChat、GetDeploymentByChatShare、GetManifest、GetOutputFileTree、GetOutputFileTreeByShare、PublishDeployment、ResolveFileURI、ResolveFileURIByShare、UnpublishDeployment
• 会员 · kimi.gateway.membership.v2.MembershipService：ClaimEventBalance、GetBalanceEventInfo、GetSubscription、GetSubscriptionStats、ListBalanceActions
• 长期记忆 · kimi.gateway.memory.v1.MemoryService：DeleteMemory、ListMemories
• 记忆仓库 · kimi.gateway.memory.v1.VaultService：GetDreamStatus、GetVaultPage、GetVaultTree、ResetDreamVault
• 杂项 · kimi.gateway.misc.v1.MiscService：GetDataSourceLocalizedInfo
• 通知 · kimi.gateway.notification.v1.NotificationService：ListUserNotifications、MarkNotificationsRead
• 商品 · kimi.gateway.order.v1.GoodsService：ListGoods
• 订阅 · kimi.gateway.order.v1.SubscriptionService：CreateSubscription、GetDiscountURL、GetPricePoster、VeryDiscountUser
• 置顶 · kimi.gateway.pin.v1.PinService：ListPinResources、PinResource、UnpinResource
• 插件 · kimi.gateway.plugin.v1.PluginService：GetPlugin、InstallPlugin、ListAvailablePlugins、ListInstalledPlugins、ListPluginCategories、ListPluginSections、UninstallPlugin
• 项目 · kimi.gateway.project.v1.ProjectService：CreateProject、DeleteProject、DeleteProjectFile、GetProject、ListProjectFiles、ListProjectUploadFiles、ListProjects、SetAvailableProjects、UpdateProject
• 营销素材 · kimi.gateway.promotionalasset.v1.PromotionalAssetService：ListPromotionalAssets
• 风控 · kimi.gateway.riskcontrol.v1.RiskControlService：ReportEvent
• 技能任务 · kimi.gateway.skill.v1.SkillJobService：CreateSkillJob、DeleteSkillJob、GetSkillJob、RetrySkillJob
• 技能 · kimi.gateway.skill.v1.SkillService：GetSkill、GetSkillFileTree、InstallSkill、ListInstalledSkills、ListSkillUseCases、ListSkills、RemoveSkill
• 幻灯片 · kimi.gateway.slides.v1.SlidesService：GetSlides
• 展示位 · kimi.gateway.suggest.v1.OpenShowcaseService：GetShowcaseByID
• 展示位 · kimi.gateway.suggest.v1.ShowcaseService：ListDefaultShowcases、ListMobileHomepageShowcases
• 推荐 · kimi.gateway.suggest.v1.SuggestService：ClaimPopupExposure、ListPopups
• 多智能体 · kimi.gateway.swarm.v1.SwarmService：ListAgentMessages、ListAgentMessagesByShare、ListAgents、StopAgents
• 触发器 · kimi.gateway.trigger.v1.TriggerService：CreateTask、DeleteTask、GetTask、ListTaskExecutions、ListTasks、MarkExecutionRead、RunTask、UpdateTask
• 语音合成 · kimi.gateway.tts.v1.TTSService：ListVoices
• 网站别名 · kimi.gateway.websites.v1.WebsiteSlugService：GetWebsiteSlug、SetWebsiteSlug、ValidateWebsiteSlug
• 远程控制 · kimi.gateway.work.v1.RemoteControlService：CreatePairing、CreateWebSocketTicket、GetPairing、ListClients、ListServers、RevokeClient
• 发件箱 · kimi.outbox.v1.OutboxService：ClearOutboxMessages、CreateOutboxMessage、DeleteOutboxMessage、ListOutboxMessages、ReorderOutboxMessages、ResumeOutbox、SendOutboxMessageNow、StopOutbox、UpdateOutboxMessage
• 用户设置 · kimi.usersetting.v1.UserSettingService：GetUserSetting、UpdateUserSetting

基础环境信息

1. APK 版本号

• 文件名 kimi_3.1.0.apk（下载源 https://appsupport.moonshot.cn/api/app/pkg/latest/android/download，302 → kimi-img.moonshot.cn/app/download/android/kimi_3.1.0.apk）
• 包名 com.moonshot.kimichat；应用名 Kimi
• versionName 3.1.0；versionCode 371
• minSdk 26 / targetSdk 36；AGP 8.13.2；单 APK，3 个 dex，dex 版本 038
• 体积 35,683,906 字节

2. 基础 Base URL

完整 URL = Base + <路径>；绝大多数服务走 /apiv2，账号服务 account.gateway.v1.AuthService 的 Logout / RefreshToken 走 /api 前缀。

3. 全局通用请求头（所有接口共用）

• 固定值：x-msh-platform=android；Content-Type 按接口类型取 application/json（Unary）或 application/connect+json（流式）。
• 动态生成：Authorization、R-Timezone、x-msh-os-version、x-msh-device-model、x-msh-device-id、x-msh-session-id、x-msh-version、x-msh-app-channel、x-msh-android-version、X-Language、X-Msh-Shield-Data。

4. 鉴权体系说明

• Token 模型：Authorization: Bearer <accessToken>；refresh token 以键 android_tech_refresh_token 持久化
• 刷新链路：access token 失效时由 AccountSessionManager（Lzr/d;）调用 /api/account.gateway.v1.AuthService/RefreshToken 换新并重放原请求
• 登录方式：短信验证码、一键登录、第三方、扫码
• 免鉴权接口：SMSService/*、AuthService/LoginWith*、AppService/ListVersions 等

5. Connect-RPC 协议简要说明

• 协议 Connect-RPC； Unary 请求用 application/json，服务端流式用 application/connect+json（实测：互换会返回 415）
• 路径 /{proto 全限定服务名}/{方法名}，如 /moment.v1.MomentService/CreateMoment
• Unary：请求/响应各为一个 JSON 对象；HTTP 方法 POST
• Server-Streaming：响应为 Connect 流帧序列，每帧负载为 ChatResponse 事件信封；HTTP 方法 POST
• 消息命名约定 <方法名>Request / <方法名>Response（同 proto 包），字段为 proto JSON 映射（camelCase）

本包内服务端流式 RPC 清单：

6. 错误码总表

错误通过 ErrorResponseV2（应用类 Lfx/o;）返回：{ code:int, message:string, details:List<ErrorDetail> }。

7. 社区信息流分类（含“热门流”）

社区首页/发现页内容由 moment.v1.FeedService/ListFeeds 驱动，用请求体 category 区分不同“流”：

• “热门流”落点：Kimi 社区 没有单独的 HOT 枚举， 热门/推荐 = FEED_CATEGORY_RECOMMEND；单条卡片用 GetFeed（feedType：FEED_TYPE_MOMENT / FEED_TYPE_INTEREST_CARD）。
• 热门话题：moment.v1.SearchService/ListHotHashtagsInSearch。
• 另有 与社区无关 的首页展示流 kimi.gateway.feed.v1.FeedService/ListFeeds，勿混淆。

8. Token 类型与刷新机制

鉴权 Token 共两类（均来自登录/刷新接口响应）：

• 获取（登录）：LoginWithSMS / LoginWithOneClick / LoginWithThirdParty / 扫码两步 → 响应 { accessToken, refreshToken, newUser, userId }。
• 刷新：POST https://www.kimi.com/api/account.gateway.v1.AuthService/RefreshToken（App 端常量表指向 /api）；请求 { refreshToken }，响应 { accessToken, refreshToken } —— 双令牌轮换，必须用新 refreshToken 覆盖旧值。 实测：该路径在 Web 生产网关返回 404（连同 8 种变体），refresh token 应视为由 登录响应直接下发 而非端点换取。
• 触发：任意接口 401/403 时自动刷新并重放；失败则跳登录。
• 登出：POST /api/account.gateway.v1.AuthService/Logout。
• 非鉴权 token：pageToken / nextPageToken 是分页游标；推送 token、tr_token、X-TC-Token、X-Msh-Shield-Data 属推送/风控，与登录态无关。

社区对话 · moment.v1.ChatService（5 个方法）

001 · CreateChatV2 — 创建动态对话

服务：moment.v1.ChatService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.ChatService/CreateChatV2

• API用途：基于动态创建一条对话（V2），返回对话 ID 供进入聊天。
• 这接口能干啥（大白话）：在动态上开一个新对话，然后跳进聊天页。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.CreateChatV2Request

字段取值：

• chatType：CHAT_TYPE_UNSPECIFIED、CHAT_TYPE_ASK_KIMI、CHAT_TYPE_CONTINUE、CHAT_TYPE_REMIX_CODE_ARTIFACT_DEEP_RESEARCH、CHAT_TYPE_REMIX_HTML、CHAT_TYPE_REMIX_IMAGE、CHAT_TYPE_REMIX_OKC_ARTIFACT

调用示例

POST https://www.kimi.com/apiv2/moment.v1.ChatService/CreateChatV2
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.CreateChatV2Response

字段取值：

• chatType：CHAT_TYPE_UNSPECIFIED、CHAT_TYPE_ASK_KIMI、CHAT_TYPE_CONTINUE、CHAT_TYPE_REMIX_CODE_ARTIFACT_DEEP_RESEARCH、CHAT_TYPE_REMIX_HTML、CHAT_TYPE_REMIX_IMAGE、CHAT_TYPE_REMIX_OKC_ARTIFACT

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

002 · GetLastChatV2 — 获取最近动态对话

服务：moment.v1.ChatService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.ChatService/GetLastChatV2

• API用途：获取某动态下用户最近一次创建的对话，实现“继续对话”。
• 这接口能干啥（大白话）：回到上次在这条动态开的对话，接着聊。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.Feed

字段取值：

• feedType：FEED_TYPE_UNSPECIFIED、FEED_TYPE_INTEREST_CARD、FEED_TYPE_MOMENT

调用示例

POST https://www.kimi.com/apiv2/moment.v1.ChatService/GetLastChatV2
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.GetLastChatV2Response

字段取值：

• chatType：CHAT_TYPE_UNSPECIFIED、CHAT_TYPE_ASK_KIMI、CHAT_TYPE_CONTINUE、CHAT_TYPE_REMIX_CODE_ARTIFACT_DEEP_RESEARCH、CHAT_TYPE_REMIX_HTML、CHAT_TYPE_REMIX_IMAGE、CHAT_TYPE_REMIX_OKC_ARTIFACT

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

003 · GetOriginalMessageCount — 获取原始消息数

服务：moment.v1.ChatService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.ChatService/GetOriginalMessageCount

• API用途：获取该动态对话可展示的原始消息条数。
• 这接口能干啥（大白话）：看这条动态对话原本有多少条消息。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.GetOriginalMessageCountRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.ChatService/GetOriginalMessageCount
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.GetOriginalMessageCountResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

004 · GetRawShareChatV2 — 获取原始分享对话

服务：moment.v1.ChatService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.ChatService/GetRawShareChatV2

• API用途：获取分享卡片对应的原始对话内容（V2）。
• 这接口能干啥（大白话）：把分享卡片背后的原始对话内容取出来。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.GetRawShareChatV2Request

调用示例

POST https://www.kimi.com/apiv2/moment.v1.ChatService/GetRawShareChatV2
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.GetRawShareChatV2Response

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

005 · ReChat — 动态追问

服务：moment.v1.ChatService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.ChatService/ReChat

• API用途：在动态对话中继续发送追问消息。
• 这接口能干啥（大白话）：在动态对话里继续追问。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.Feed

字段取值：

• feedType：FEED_TYPE_UNSPECIFIED、FEED_TYPE_INTEREST_CARD、FEED_TYPE_MOMENT

调用示例

POST https://www.kimi.com/apiv2/moment.v1.ChatService/ReChat
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ReChatResponse

字段取值：

• chatType：CHAT_TYPE_UNSPECIFIED、CHAT_TYPE_ASK_KIMI、CHAT_TYPE_CONTINUE、CHAT_TYPE_REMIX_CODE_ARTIFACT_DEEP_RESEARCH、CHAT_TYPE_REMIX_HTML、CHAT_TYPE_REMIX_IMAGE、CHAT_TYPE_REMIX_OKC_ARTIFACT

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

社区-评论 · moment.v1.CommentService（5 个方法）

006 · CreateComment — 发表评论

服务：moment.v1.CommentService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.CommentService/CreateComment

• API用途：对动态发表评论或回复某条评论（parentCommentId），支持 @ 用户与图片。
• 这接口能干啥（大白话）：发评论；也能回复别人的评论（带 targetCommentId）。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.CreateCommentRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.CommentService/CreateComment
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.CreateCommentResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

007 · DeleteComment — 删除评论

服务：moment.v1.CommentService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.CommentService/DeleteComment

• API用途：删除自己的评论；若有子评论会一并影响展示。
• 这接口能干啥（大白话）：删掉自己的评论。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.DeleteCommentRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.CommentService/DeleteComment
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式

无独立 Response 消息；通常返回空对象 {}（删除/无返回体类接口）。

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 删除类操作不可逆，客户端应二次确认。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 删除类操作不可逆，客户端应二次确认。

008 · ListComments — 列出评论

服务：moment.v1.CommentService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.CommentService/ListComments

• API用途：分页拉取某动态的一级评论列表。
• 这接口能干啥（大白话）：拉一页这条动态下的评论。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.Feed

字段取值：

• feedType：FEED_TYPE_UNSPECIFIED、FEED_TYPE_INTEREST_CARD、FEED_TYPE_MOMENT

调用示例

POST https://www.kimi.com/apiv2/moment.v1.CommentService/ListComments
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListCommentsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

009 · ListSubComments — 列出子评论

服务：moment.v1.CommentService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.CommentService/ListSubComments

• API用途：拉取某条评论下的二级（子）评论列表。
• 这接口能干啥（大白话）：看某条评论下面的回复（二级评论）。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ListCommentsResponse

调用示例

POST https://www.kimi.com/apiv2/moment.v1.CommentService/ListSubComments
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListSubCommentsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

010 · VoteComment — 评论点赞/投票

服务：moment.v1.CommentService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.CommentService/VoteComment

• API用途：对评论执行点赞/取消点赞/点踩，action 决定方向。
• 这接口能干啥（大白话）：给评论点赞、取消点赞或点踩。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.VoteCommentRequest

字段取值：

• voteAction：COMMENT_VOTE_ACTION_UNSPECIFIED、COMMENT_VOTE_ACTION_CANCEL_DISLIKE、COMMENT_VOTE_ACTION_CANCEL_LIKE、COMMENT_VOTE_ACTION_DISLIKE、COMMENT_VOTE_ACTION_LIKE

调用示例

POST https://www.kimi.com/apiv2/moment.v1.CommentService/VoteComment
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.VoteCommentResponse

（空消息，无字段）

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

社区-举报 · moment.v1.ComplaintService（1 个方法）

011 · CreateComplaint — 提交举报

服务：moment.v1.ComplaintService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.ComplaintService/CreateComplaint

• API用途：对动态/评论/用户提交举报，含举报类型、原因与佐证材料。
• 这接口能干啥（大白话）：举报动态/评论/用户，选类型写理由。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.CreateComplaintRequest

字段取值：

• objectType：COMPLAINT_OBJECT_TYPE_UNSPECIFIED、COMPLAINT_OBJECT_TYPE_COMMENT、COMPLAINT_OBJECT_TYPE_MOMENT、COMPLAINT_OBJECT_TYPE_USER

调用示例

POST https://www.kimi.com/apiv2/moment.v1.ComplaintService/CreateComplaint
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.CreateComplaintResponse

（空消息，无字段）

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

社区配置 · moment.v1.ConfigService（1 个方法）

012 · GetConfig — 获取社区配置

服务：moment.v1.ConfigService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.ConfigService/GetConfig

• API用途：拉取社区模块的功能开关、文案与阈值配置。
• 这接口能干啥（大白话）：拉社区的功能开关和文案配置。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.GetConfigRequest

（空消息，无字段）

调用示例

POST https://www.kimi.com/apiv2/moment.v1.ConfigService/GetConfig
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.GetConfigResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

社区-收藏 · moment.v1.FavoriteService（2 个方法）

013 · CreateFavorite — 收藏动态

服务：moment.v1.FavoriteService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.FavoriteService/CreateFavorite

• API用途：收藏一条动态到个人收藏夹，支持分组/备注。
• 这接口能干啥（大白话）：把动态收进自己的收藏夹。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.CreateFavoriteRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.FavoriteService/CreateFavorite
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.CreateFavoriteResponse

（空消息，无字段）

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

014 · DeleteFavorite — 取消收藏

服务：moment.v1.FavoriteService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.FavoriteService/DeleteFavorite

• API用途：取消对某条动态的收藏。
• 这接口能干啥（大白话）：取消收藏。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.DeleteFavoriteRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.FavoriteService/DeleteFavorite
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.DeleteFavoriteResponse

（空消息，无字段）

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 删除类操作不可逆，客户端应二次确认。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 删除类操作不可逆，客户端应二次确认。

社区信息流 · moment.v1.FeedService（4 个方法）

015 · GetFeed — 获取信息流

服务：moment.v1.FeedService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.FeedService/GetFeed

• API用途：按 feed 场景（推荐/关注/话题）拉取信息流单页数据，支持游标分页。
• 这接口能干啥（大白话）：打开某条动态/某类卡片看详情时用。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.GetFeedRequest

字段取值：

• feedType：FEED_TYPE_UNSPECIFIED、FEED_TYPE_INTEREST_CARD、FEED_TYPE_MOMENT

调用示例

POST https://www.kimi.com/apiv2/moment.v1.FeedService/GetFeed
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.GetFeedResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

016 · ListFeeds — 列出信息流列表

服务：moment.v1.FeedService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.FeedService/ListFeeds

• API用途：批量拉取多个 feed 的信息流内容，社区首页主接口。
• 这接口能干啥（大白话）：刷社区首页靠它：按分类拉一页动态（推荐/关注/话题/我的收藏/我点赞/我发布），翻页用 pageToken。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ListFeedsRequest

字段取值：

• category：FEED_CATEGORY_UNSPECIFIED、FEED_CATEGORY_FOLLOW、FEED_CATEGORY_HASHTAG、FEED_CATEGORY_RECOMMEND、FEED_CATEGORY_USER_FAVORITE、FEED_CATEGORY_USER_LIKES、FEED_CATEGORY_USER_PUBLISH

调用示例

POST https://www.kimi.com/apiv2/moment.v1.FeedService/ListFeeds
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListFeedsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

017 · ListFollowUnread — 关注动态未读列表

服务：moment.v1.FeedService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.FeedService/ListFollowUnread

• API用途：拉取“关注”流中未读的新动态，用于红点与未读提示。
• 这接口能干啥（大白话）：看“关注”里有没有新动态，用来点亮红点。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ListFollowUnreadRequest

（空消息，无字段）

调用示例

POST https://www.kimi.com/apiv2/moment.v1.FeedService/ListFollowUnread
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListFollowUnreadResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

018 · MarkReadForFollow — 标记关注流已读

服务：moment.v1.FeedService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.FeedService/MarkReadForFollow

• API用途：把关注流中的动态标记为已读，清除未读红点。
• 这接口能干啥（大白话）：把关注流的新动态看过，清掉红点。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.MarkReadForFollowRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.FeedService/MarkReadForFollow
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.MarkReadForFollowResponse

（空消息，无字段）

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

社区-关注 · moment.v1.FollowService（3 个方法）

019 · ListFollows — 列出关注关系

服务：moment.v1.FollowService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.FollowService/ListFollows

• API用途：分页列出某用户的关注/粉丝列表（followers/following）。
• 这接口能干啥（大白话）：看某人的关注列表或粉丝列表。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ListFollowsRequest

字段取值：

• followType：FOLLOW_TYPE_UNSPECIFIED、FOLLOW_TYPE_FOLLOWERS、FOLLOW_TYPE_FOLLOWINGS

调用示例

POST https://www.kimi.com/apiv2/moment.v1.FollowService/ListFollows
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListFollowsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

020 · ModifyBlock — 拉黑/解除拉黑

服务：moment.v1.FollowService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.FollowService/ModifyBlock

• API用途：拉黑或解除拉黑某用户，拉黑后互相不可见动态与评论。
• 这接口能干啥（大白话）：拉黑某人，或把某人从黑名单放出来。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ModifyBlockRequest

字段取值：

• action：BLOCK_ACTION_UNSPECIFIED、BLOCK_ACTION_BLOCK、BLOCK_ACTION_UNBLOCK

调用示例

POST https://www.kimi.com/apiv2/moment.v1.FollowService/ModifyBlock
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ModifyBlockResponse

字段取值：

• blockStatus：BLOCK_STATUS_UNSPECIFIED、BLOCK_STATUS_BLOCKED、BLOCK_STATUS_NOT_BLOCKED

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

021 · ModifyFollow — 关注/取关

服务：moment.v1.FollowService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.FollowService/ModifyFollow

• API用途：关注或取消关注某用户，action 决定方向。
• 这接口能干啥（大白话）：关注或取关某人。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ModifyFollowRequest

字段取值：

• action：FOLLOW_ACTION_UNSPECIFIED、FOLLOW_ACTION_FOLLOW、FOLLOW_ACTION_UNFOLLOW

调用示例

POST https://www.kimi.com/apiv2/moment.v1.FollowService/ModifyFollow
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ModifyFollowResponse

字段取值：

• followStatus：FOLLOW_STATUS_UNSPECIFIED、FOLLOW_STATUS_FOLLOWED、FOLLOW_STATUS_FOLLOWING、FOLLOW_STATUS_MUTUAL_FOLLOWING、FOLLOW_STATUS_NOT_FOLLOWING

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

社区-话题 · moment.v1.HashtagService（3 个方法）

022 · GetHashtag — 获取话题详情

服务：moment.v1.HashtagService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.HashtagService/GetHashtag

• API用途：按话题 ID 获取话题详情（标题、简介、参与量、代表动态）。
• 这接口能干啥（大白话）：看一个话题的详情（介绍、热度、代表动态）。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.GetHashtagRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.HashtagService/GetHashtag
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.GetHashtagResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

023 · ListHashtags — 列出话题

服务：moment.v1.HashtagService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.HashtagService/ListHashtags

• API用途：分页列出话题列表（热门/推荐/全部）。
• 这接口能干啥（大白话）：列出话题列表。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ListHashtagsRequest

（空消息，无字段）

调用示例

POST https://www.kimi.com/apiv2/moment.v1.HashtagService/ListHashtags
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListHashtagsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

024 · RecommendHashtags — 推荐话题

服务：moment.v1.HashtagService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.HashtagService/RecommendHashtags

• API用途：基于输入文本或草稿推荐相关话题，发布动态时的话题联想。
• 这接口能干啥（大白话）：你打字时帮你联想该加什么话题。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.RecommendHashtagsRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.HashtagService/RecommendHashtags
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.RecommendHashtagsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

社区-兴趣 · moment.v1.InterestService（2 个方法）

025 · ReportSelections — 上报兴趣选择

服务：moment.v1.InterestService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.InterestService/ReportSelections

• API用途：上报兴趣标签的曝光/选择行为，用于推荐调优。
• 这接口能干啥（大白话）：把你对兴趣标签的曝光/选择行为回报给推荐。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ReportSelectionsRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.InterestService/ReportSelections
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ReportSelectionsResponse

（空消息，无字段）

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

026 · SubmitSelections — 提交兴趣选择

服务：moment.v1.InterestService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.InterestService/SubmitSelections

• API用途：新用户兴趣冷启动：提交所选兴趣标签。
• 这接口能干啥（大白话）：新用户选兴趣标签，决定一开始给你推什么。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.SubmitSelectionsRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.InterestService/SubmitSelections
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.SubmitSelectionsResponse

（空消息，无字段）

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

社区-动态 · moment.v1.MomentService（6 个方法）

027 · CreateMoment — 发布动态

服务：moment.v1.MomentService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.MomentService/CreateMoment

• API用途：发布一条社区动态（moment），支持图文、话题、@ 用户、关联对话分享卡片（chatShareId）。文本与图片分别通过 text / images 上传；发布成功返回动态 ID。
• 这接口能干啥（大白话）：发动态：配文字、图片、话题、@人，还能带上一条对话分享卡片。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.CreateMomentRequest

字段取值：

• visibility：MOMENT_VISIBILITY_UNSPECIFIED、MOMENT_VISIBILITY_PUBLIC、MOMENT_VISIBILITY_SELF

调用示例

POST https://www.kimi.com/apiv2/moment.v1.MomentService/CreateMoment
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.CreateMomentResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

028 · DeleteMoment — 删除动态

服务：moment.v1.MomentService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.MomentService/DeleteMoment

• API用途：删除自己发布的动态。仅作者本人可删；成功后该动态从信息流与个人主页移除。
• 这接口能干啥（大白话）：删掉自己发的动态。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.DeleteMomentRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.MomentService/DeleteMoment
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式

无独立 Response 消息；通常返回空对象 {}（删除/无返回体类接口）。

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 删除类操作不可逆，客户端应二次确认。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 删除类操作不可逆，客户端应二次确认。

029 · GetChatShareCard — 获取对话分享卡片

服务：moment.v1.MomentService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.MomentService/GetChatShareCard

• API用途：获取动态内嵌的对话分享卡片（ChatShareCard）渲染数据。
• 这接口能干啥（大白话）：把动态里内嵌的对话分享卡片渲染出来。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.GetChatShareCardRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.MomentService/GetChatShareCard
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.GetChatShareCardResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

030 · ListMomentAskKimiQuestions — 列出动态提问

服务：moment.v1.MomentService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.MomentService/ListMomentAskKimiQuestions

• API用途：获取某动态下“问 Kimi”生成的问题列表及其回答入口。
• 这接口能干啥（大白话）：看别人在这条动态下问了 Kimi 什么问题、Kimi 怎么答的。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ListMomentAskKimiQuestionsRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.MomentService/ListMomentAskKimiQuestions
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListMomentAskKimiQuestionsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

031 · ListSimilarMoments — 列出相似动态

服务：moment.v1.MomentService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.MomentService/ListSimilarMoments

• API用途：按当前动态内容/话题召回相似动态列表，用于详情页“更多相似内容”推荐。
• 这接口能干啥（大白话）：看“更多相似动态”，在动态详情页往下刷类似内容。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ListSimilarMomentsRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.MomentService/ListSimilarMoments
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListSimilarMomentsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

032 · VoteMoment — 动态点赞/投票

服务：moment.v1.MomentService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.MomentService/VoteMoment

• API用途：对动态执行投票动作（点赞/取消点赞/点踩等），action 决定方向。这是社区“点赞”的核心接口。
• 这接口能干啥（大白话）：给动态点赞、取消点赞或点踩。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.VoteMomentRequest

字段取值：

• voteAction：MOMENT_VOTE_ACTION_UNSPECIFIED、MOMENT_VOTE_ACTION_CANCEL_DISLIKE、MOMENT_VOTE_ACTION_CANCEL_LIKE、MOMENT_VOTE_ACTION_DISLIKE、MOMENT_VOTE_ACTION_LIKE

调用示例

POST https://www.kimi.com/apiv2/moment.v1.MomentService/VoteMoment
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.VoteMomentResponse

（空消息，无字段）

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

社区-屏蔽 · moment.v1.MuteService（4 个方法）

033 · AppendMuteReasons — 追加上报屏蔽原因

服务：moment.v1.MuteService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.MuteService/AppendMuteReasons

• API用途：用户执行屏蔽时追加/上报具体屏蔽原因，用于个性化推荐。
• 这接口能干啥（大白话）：把你选的屏蔽原因上报给推荐系统。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.AppendMuteReasonsRequest

字段取值：

• objectType：MUTE_OBJECT_TYPE_UNSPECIFIED、MUTE_OBJECT_TYPE_AIGC_MOMENT_CONTENT、MUTE_OBJECT_TYPE_BOT_COMMENT、MUTE_OBJECT_TYPE_MOMENT

调用示例

POST https://www.kimi.com/apiv2/moment.v1.MuteService/AppendMuteReasons
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.AppendMuteReasonsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

034 · ListMuteReasons — 列出屏蔽原因

服务：moment.v1.MuteService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.MuteService/ListMuteReasons

• API用途：拉取可供选择的屏蔽原因枚举列表。
• 这接口能干啥（大白话）：拉出“为什么不想看”的可选原因。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ListMuteReasonsRequest

字段取值：

• objectType：MUTE_OBJECT_TYPE_UNSPECIFIED、MUTE_OBJECT_TYPE_AIGC_MOMENT_CONTENT、MUTE_OBJECT_TYPE_BOT_COMMENT、MUTE_OBJECT_TYPE_MOMENT

调用示例

POST https://www.kimi.com/apiv2/moment.v1.MuteService/ListMuteReasons
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListMuteReasonsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

035 · Mute — 屏蔽内容/用户

服务：moment.v1.MuteService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.MuteService/Mute

• API用途：屏蔽指定用户或内容（含屏蔽原因），屏蔽后不再出现于信息流。
• 这接口能干啥（大白话）：不想再看到某人/某内容，直接屏蔽。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.MuteRequest

字段取值：

• objectType：MUTE_OBJECT_TYPE_UNSPECIFIED、MUTE_OBJECT_TYPE_AIGC_MOMENT_CONTENT、MUTE_OBJECT_TYPE_BOT_COMMENT、MUTE_OBJECT_TYPE_MOMENT

调用示例

POST https://www.kimi.com/apiv2/moment.v1.MuteService/Mute
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.MuteResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

036 · UnMute — 取消屏蔽

服务：moment.v1.MuteService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.MuteService/UnMute

• API用途：解除对某用户/内容的屏蔽。
• 这接口能干啥（大白话）：解除屏蔽。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.UnMuteRequest

字段取值：

• objectType：MUTE_OBJECT_TYPE_UNSPECIFIED、MUTE_OBJECT_TYPE_AIGC_MOMENT_CONTENT、MUTE_OBJECT_TYPE_BOT_COMMENT、MUTE_OBJECT_TYPE_MOMENT

调用示例

POST https://www.kimi.com/apiv2/moment.v1.MuteService/UnMute
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.UnMuteResponse

（空消息，无字段）

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

社区通知 · moment.v1.NotificationService（5 个方法）

037 · GetReminderStatus — 获取提醒状态

服务：moment.v1.NotificationService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.NotificationService/GetReminderStatus

• API用途：获取提醒的汇总状态（各类型未读数）。
• 这接口能干啥（大白话）：看各类提醒的未读数（小红点数字）。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.GetReminderStatusRequest

（空消息，无字段）

调用示例

POST https://www.kimi.com/apiv2/moment.v1.NotificationService/GetReminderStatus
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.GetReminderStatusResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

038 · ListNotification — 列出社区通知

服务：moment.v1.NotificationService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.NotificationService/ListNotification

• API用途：分页拉取社区通知（点赞/评论/关注等）。
• 这接口能干啥（大白话）：看社区里的通知（谁点赞、谁评论、谁关注）。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ListNotificationRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.NotificationService/ListNotification
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListNotificationResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

039 · ListReminders — 列出提醒

服务：moment.v1.NotificationService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.NotificationService/ListReminders

• API用途：拉取社区提醒（未读消息/待处理）列表。
• 这接口能干啥（大白话）：看社区提醒列表。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ListRemindersRequest

（空消息，无字段）

调用示例

POST https://www.kimi.com/apiv2/moment.v1.NotificationService/ListReminders
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListRemindersResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

040 · MarkRead — 标记通知已读

服务：moment.v1.NotificationService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.NotificationService/MarkRead

• API用途：将指定社区通知标记为已读。
• 这接口能干啥（大白话）：把社区通知标成已读。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.MarkReadRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.NotificationService/MarkRead
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.MarkReadResponse

（空消息，无字段）

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

041 · MarkReadForReminder — 标记提醒已读

服务：moment.v1.NotificationService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.NotificationService/MarkReadForReminder

• API用途：把某类型提醒标记为已读。
• 这接口能干啥（大白话）：把某类提醒标成已读。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.MarkReadForReminderRequest

（空消息，无字段）

调用示例

POST https://www.kimi.com/apiv2/moment.v1.NotificationService/MarkReadForReminder
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.MarkReadForReminderResponse

（空消息，无字段）

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

社区搜索 · moment.v1.SearchService（5 个方法）

042 · ListHotHashtagsInSearch — 搜索页热门话题

服务：moment.v1.SearchService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.SearchService/ListHotHashtagsInSearch

• API用途：搜索入口页展示的热门话题列表。
• 这接口能干啥（大白话）：搜索页顶部展示的热门话题。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ListHotHashtagsInSearchRequest

（空消息，无字段）

调用示例

POST https://www.kimi.com/apiv2/moment.v1.SearchService/ListHotHashtagsInSearch
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListHotHashtagsInSearchResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

043 · SearchHashtags — 搜索话题

服务：moment.v1.SearchService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.SearchService/SearchHashtags

• API用途：按关键词搜索话题。
• 这接口能干啥（大白话）：按关键词搜话题。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.SearchHashtagsRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.SearchService/SearchHashtags
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.SearchHashtagsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

044 · SearchMoments — 搜索动态

服务：moment.v1.SearchService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.SearchService/SearchMoments

• API用途：按关键词搜索动态，返回命中动态列表与高亮信息。
• 这接口能干啥（大白话）：按关键词搜动态。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.SearchMomentsRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.SearchService/SearchMoments
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.SearchMomentsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

045 · SearchUsers — 搜索用户

服务：moment.v1.SearchService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.SearchService/SearchUsers

• API用途：按关键词搜索社区用户。
• 这接口能干啥（大白话）：按关键词搜用户。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.SearchUsersRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.SearchService/SearchUsers
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.SearchUsersResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

046 · SuggestSearchQuery — 搜索联想词

服务：moment.v1.SearchService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.SearchService/SuggestSearchQuery

• API用途：输入时返回搜索联想词/补全建议。
• 这接口能干啥（大白话）：搜索框里给联想词/补全。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.SuggestSearchQueryRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.SearchService/SuggestSearchQuery
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.SuggestSearchQueryResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

社区-上传 · moment.v1.UploadService（2 个方法）

047 · CreateFile — 登记上传文件

服务：moment.v1.UploadService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.UploadService/CreateFile

• API用途：图片直传完成后，把对象存储 key 登记为社区文件，返回可引用的文件 ID/URL。
• 这接口能干啥（大白话）：图片传完后登记一下，拿到社区里能引用的文件。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.CreateFileRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.UploadService/CreateFile
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.CreateFileResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

048 · GeneratePresignedURL — 获取上传预签名 URL

服务：moment.v1.UploadService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.UploadService/GeneratePresignedURL

• API用途：为动态图片/文件申请对象存储预签名直传 URL（PUT 到 OSS/COS）。
• 这接口能干啥（大白话）：发图前先拿一个直传地址，图片直接传到云存储。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.GeneratePresignedURLRequest

字段取值：

• fileType：FILE_TYPE_UNSPECIFIED、FILE_TYPE_FILE、FILE_TYPE_IMAGE

调用示例

POST https://www.kimi.com/apiv2/moment.v1.UploadService/GeneratePresignedURL
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.GeneratePresignedURLResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

社区用户 · moment.v1.UserService（3 个方法）

049 · GetMe — 获取我的社区资料

服务：moment.v1.UserService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.UserService/GetMe

• API用途：获取当前登录用户的社区侧资料（昵称、头像、统计、关注数等）。
• 这接口能干啥（大白话）：看自己的社区资料（昵称、头像、粉丝/关注数）。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.GetMeRequest

字段取值：

• view：USER_PROFILE_VIEW_UNSPECIFIED、USER_PROFILE_VIEW_BASIC、USER_PROFILE_VIEW_FULL、USER_PROFILE_VIEW_LITE

调用示例

POST https://www.kimi.com/apiv2/moment.v1.UserService/GetMe
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.GetMeResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

050 · GetUserProfile — 获取用户主页

服务：moment.v1.UserService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.UserService/GetUserProfile

• API用途：按用户 ID 获取社区主页资料与关系状态（是否已关注/是否拉黑/是否互关）。
• 这接口能干啥（大白话）：看别人的社区主页，顺带知道你有没有关注/拉黑对方。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.GetUserProfileRequest

调用示例

POST https://www.kimi.com/apiv2/moment.v1.UserService/GetUserProfile
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.GetUserProfileResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

051 · ListMentionableBots — 列出可 @ 的机器人

服务：moment.v1.UserService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/moment.v1.UserService/ListMentionableBots

• API用途：列出当前可在动态/评论中 @ 的机器人（Kimi 智能体）列表。
• 这接口能干啥（大白话）：列出发动态/评论时能 @ 的机器人。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.moment.v1.ListMentionableBotsRequest

字段取值：

• sceneType：MENTIONABLE_SCENE_TYPE_UNSPECIFIED、MENTIONABLE_SCENE_TYPE_AGENT、MENTIONABLE_SCENE_TYPE_COMMENT_KIMI

调用示例

POST https://www.kimi.com/apiv2/moment.v1.UserService/ListMentionableBots
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.moment.v1.ListMentionableBotsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

对话 · kimi.gateway.chat.v1.ChatService（28 个方法）

052 · BatchDeleteChats — 批量删除会话

服务：kimi.gateway.chat.v1.ChatService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/BatchDeleteChats

• API用途：批量删除会话。
• 这接口能干啥（大白话）：一次删掉多个会话。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.kimi.gateway.chat.v1.BatchDeleteChatsRequest

调用示例

POST https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/BatchDeleteChats
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.kimi.gateway.chat.v1.BatchDeleteChatsResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 删除类操作不可逆，客户端应二次确认。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 删除类操作不可逆，客户端应二次确认。

053 · CancelChat — 取消对话

服务：kimi.gateway.chat.v1.ChatService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/CancelChat

• API用途：取消正在进行的生成。
• 这接口能干啥（大白话）：正在生成时点“停止”就调它。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.kimi.gateway.chat.v1.CancelChatRequest

调用示例

POST https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/CancelChat
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.kimi.gateway.chat.v1.CancelChatResponse

（空消息，无字段）

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

054 · Chat — 发起对话（流式）

服务：kimi.gateway.chat.v1.ChatService · 协议：流式 · HTTP：POST

地址：https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/Chat

• API用途：服务端流式发起一轮对话，逐块返回 SSE/Connect 流事件（思考、正文增量、工具调用、引用等）。
• 这接口能干啥（大白话）：发消息聊天，回答是一点点“流”出来的（打字机效果）。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.kimi.gateway.chat.v1.ChatRequest

字段取值：

• scenario：SCENARIO_UNSPECIFIED、SCENARIO_AUTOMATION、SCENARIO_AUTOMATION_K3、SCENARIO_BOT、SCENARIO_CHAT、SCENARIO_DEEP_RESEARCH、SCENARIO_K2、SCENARIO_K2D5、SCENARIO_K3、SCENARIO_KIMI_PLUS、SCENARIO_KODER、SCENARIO_OK_COMPUTER、SCENARIO_OK_COMPUTER_SWARM、SCENARIO_PROBLEM_SOLVE、SCENARIO_SKILLCREATOR、SCENARIO_SLIDES、SCENARIO_THINK

调用示例

POST https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/Chat
Content-Type: application/connect+json
Authorization: Bearer <accessToken>
x-msh-device-id: <deviceId>
Body(JSON): { ...<Request 字段>... }
--> 200 OK；响应为 Connect 流帧，逐帧 JSON 解析

返回格式

字段取值：

• op：OPERATOR_UNSPECIFIED、append、set

流式响应： 无单一 Response 消息，为 Connect 事件帧序列（帧负载 = ChatResponse 事件信封）。

返回解析说明

逐帧按行解析，按事件名（字段存在性）分派；error 帧需中断并展示错误；最后处理连接关闭/超时重连；断线后可用 ContinueChat/ResumeChat 续传。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 流式接口：需处理增量事件、心跳与断线重连。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 流式接口：需处理增量事件、心跳与断线重连。

055 · ChatFromCase — 案例对话（流式）

服务：kimi.gateway.chat.v1.ChatService · 协议：流式 · HTTP：POST

地址：https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/ChatFromCase

• API用途：从案例/模板发起对话（流式）。
• 这接口能干啥（大白话）：从案例/模板一键开启一段对话。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.kimi.gateway.chat.v1.ChatFromCaseRequest

调用示例

POST https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/ChatFromCase
Content-Type: application/connect+json
Authorization: Bearer <accessToken>
x-msh-device-id: <deviceId>
Body(JSON): { ...<Request 字段>... }
--> 200 OK；响应为 Connect 流帧，逐帧 JSON 解析

返回格式

字段取值：

• op：OPERATOR_UNSPECIFIED、append、set

流式响应： 无单一 Response 消息，为 Connect 事件帧序列（帧负载 = ChatResponse 事件信封）。

返回解析说明

逐帧按行解析，按事件名（字段存在性）分派；error 帧需中断并展示错误；最后处理连接关闭/超时重连；断线后可用 ContinueChat/ResumeChat 续传。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 流式接口：需处理增量事件、心跳与断线重连。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 流式接口：需处理增量事件、心跳与断线重连。

056 · ContinueChat — 继续对话（流式）

服务：kimi.gateway.chat.v1.ChatService · 协议：流式 · HTTP：POST

地址：https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/ContinueChat

• API用途：对已中断/待继续的对话继续生成（流式）。
• 这接口能干啥（大白话）：对话被中断后接着往下生成。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.kimi.gateway.chat.v1.ContinueChatRequest

调用示例

POST https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/ContinueChat
Content-Type: application/connect+json
Authorization: Bearer <accessToken>
x-msh-device-id: <deviceId>
Body(JSON): { ...<Request 字段>... }
--> 200 OK；响应为 Connect 流帧，逐帧 JSON 解析

返回格式

字段取值：

• op：OPERATOR_UNSPECIFIED、append、set

流式响应： 无单一 Response 消息，为 Connect 事件帧序列（帧负载 = ChatResponse 事件信封）。

返回解析说明

逐帧按行解析，按事件名（字段存在性）分派；error 帧需中断并展示错误；最后处理连接关闭/超时重连；断线后可用 ContinueChat/ResumeChat 续传。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 流式接口：需处理增量事件、心跳与断线重连。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 流式接口：需处理增量事件、心跳与断线重连。

057 · CreateChatFromShare — 创建由分享创建的会话

服务：kimi.gateway.chat.v1.ChatService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/CreateChatFromShare

• API用途：对话模块接口：创建由分享创建的会话（proto 方法 ChatService.CreateChatFromShare）。
• 这接口能干啥（大白话）：对话：新建由分享创建的会话。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.kimi.gateway.chat.v1.CreateChatFromShareRequest

调用示例

POST https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/CreateChatFromShare
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.kimi.gateway.chat.v1.CreateChatFromShareResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

058 · CreateChatShare — 创建对话分享

服务：kimi.gateway.chat.v1.ChatService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/CreateChatShare

• API用途：对话模块接口：创建对话分享（proto 方法 ChatService.CreateChatShare）。
• 这接口能干啥（大白话）：对话：新建对话分享。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.kimi.gateway.chat.v1.CreateChatShareRequest

调用示例

POST https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/CreateChatShare
Content-Type: application/json
Authorization: Bearer <accessToken>
x-msh-platform: android
x-msh-version: 3.1.0
X-Language: zh-CN
X-Msh-Shield-Data: <risk>
Body(JSON): { ...<Request 字段>... }
--> 200 OK, body = JSON(<Response>)

返回格式 — com.moonshot.kimi.proto.kimi.gateway.chat.v1.CreateChatShareResponse

返回解析说明

按 proto JSON 解析为 Response 对象；code != 0 时读取 message 与 details；401/403 触发 token 刷新或登录引导；429 触发退避重试。

特殊备注

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

• 所有请求必须携带设备头（x-msh-*）与风控头（X-Msh-Shield-Data），否则可能被风控拦截。

• 创建类接口需注意幂等/防重复提交。

059 · GetChat — 获取会话

服务：kimi.gateway.chat.v1.ChatService · 协议：Unary · HTTP：POST

地址：https://www.kimi.com/apiv2/kimi.gateway.chat.v1.ChatService/GetChat

• API用途：获取单个会话详情及消息。
• 这接口能干啥（大白话）：打开某个会话看内容。

请求头：全局通用 18 项（见「3. 全局通用请求头」）

请求体 — com.moonshot.kimi.proto.kimi.gateway.chat.v1.GetChatRequest

调用示例