用途：本技能整理 Fireflies.ai 转录 API 的行为、GraphQL schema、webhook 模式与已知特性，供开发者在对接 Fireflies 上传、webhook 与转录数据时参考。
接口与认证：API 端点为 https://api.fireflies.ai/graphql，仅提供 GraphQL，无 REST。认证方式为请求头 Authorization: Bearer <FIREFLIES_API_KEY>。
上传流程：使用 uploadAudio mutation，输入字段包括 url（必填，公开可访问的音视频地址，预签名 S3/MinIO 链接可用）、title、webhook（转录完成时 POST 的地址）、client_reference_id（回传用于关联的不透明字符串）。响应仅返回 success、title、message，不返回 meeting ID，因此上传后无法按 ID 轮询，必须依赖 webhook。
Webhook 行为：Fireflies 在转录过程中发送渐进式 webhook，而非完成时单次回调。70 分钟录音可能产生 50-150+ 次 POST，每次 meetingId 不同，代表逐步变长的转录片段；早期为部分内容，最后一次为完整转录。载荷包含 meetingId、clientReferenceId、eventType。需按 clientReferenceId 去抖，建议 2 分钟无新 webhook 后用最新 meetingId 拉取转录，否则会产生大量重复或部分文件。
转录查询：使用 transcript 查询，可获取 id、title、日期、时长、各类 URL、参与者、speakers、sentences（含说话人归属与时间戳，是权威转录内容）、user、meeting_attendees、summary、meeting_info 等字段。
已知特性：duration 单位为分钟（浮点）；date 为毫秒级 Unix 时间戳；无历史说话人数据时说话人名为通用编号；长上传触发上述 webhook 风暴，短上传通常仅 1-3 次；summary 可能为 null；meeting_info.summary_status 可指示摘要是否生成完成。
限制：资料未提供速率限制、配额、价格与错误码等细节。