{"openapi":"3.0.1","info":{"title":"FeedHub (灵机) API Skill","description":"FeedHub AI 智能录音卡与第二大脑平台开放 API。支持智能体查询录音、获取结构化会议纪要与脑图、搜索知识库以及一键推送到工作群。","version":"1.0.0"},"servers":[{"url":"https://www.feedhub.cc","description":"FeedHub Production API"}],"paths":{"/api/recordings":{"get":{"summary":"查询录音列表","description":"获取当前用户的录音列表，支持按标题、标签关键词搜索和分页。","operationId":"listRecordings","parameters":[{"name":"limit","in":"query","description":"返回记录数（默认 20，最大 100）","required":false,"schema":{"type":"integer","default":20}},{"name":"offset","in":"query","description":"分页偏移量","required":false,"schema":{"type":"integer","default":0}},{"name":"query","in":"query","description":"按会议标题或内容进行关键词模糊匹配","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功返回录音列表","content":{"application/json":{"schema":{"type":"object","properties":{"recordings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"durationSec":{"type":"integer"},"createdAt":{"type":"string"},"summary":{"type":"string"},"transcript":{"type":"string"},"epiphany":{"type":"string"},"deepResearch":{"type":"string"},"audioUrl":{"type":"string"},"status":{"type":"string"}}}}}}}}}},"security":[{"BearerAuth":[]}]}},"/api/recordings/{id}":{"get":{"summary":"获取单条录音详情","description":"根据录音 ID 获取完整转录文本、结构化纪要、思维导图与商业洞察。","operationId":"getRecordingDetail","parameters":[{"name":"id","in":"path","required":true,"description":"录音唯一标识 ID","schema":{"type":"string"}}],"responses":{"200":{"description":"返回录音详细内容","content":{"application/json":{"schema":{"type":"object","properties":{"recording":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"transcript":{"type":"string"},"summary":{"type":"string"},"mindmap":{"type":"string"},"epiphany":{"type":"string"},"deepResearch":{"type":"string"},"todos":{"type":"string"},"segments":{"type":"array","items":{"type":"object"}},"audioUrl":{"type":"string"},"createdAt":{"type":"string"}}}}}}}}},"security":[{"BearerAuth":[]}]}},"/api/integrations/push":{"post":{"summary":"推送纪要到工作群","description":"将指定录音的会议纪要、待办和脑图一键推送到企业微信、飞书、钉钉、微信群或 Slack。","operationId":"pushToChannel","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["recordingId"],"properties":{"recordingId":{"type":"string","description":"需要推送的录音 ID"},"channel":{"type":"string","description":"推送通道: wecom, feishu, dingtalk, wechat, slack, all"},"customNote":{"type":"string","description":"附加备注"}}}}}},"responses":{"200":{"description":"推送结果","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"}}}}}}},"security":[{"BearerAuth":[]}]}},"/api/skill/quota":{"get":{"summary":"查询用户转录额度与会员状态","description":"获取当前 API Key 对应账号的剩余转录分钟数、会员等级和有效期。","operationId":"getUserQuota","responses":{"200":{"description":"成功返回额度信息","content":{"application/json":{"schema":{"type":"object","properties":{"membershipTier":{"type":"string"},"quotaMinutesRemaining":{"type":"integer"},"membershipExpireAt":{"type":"string"}}}}}}},"security":[{"BearerAuth":[]}]}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"在 FeedHub 控制台生成的 API Key，请求头携带 Authorization: Bearer <YOUR_API_KEY>"}}}}