前置条件
- 1已安装飞书客户端（桌面版 7.0 以上）
- 2拥有飞书账号（自建应用需企业版租户）
- 3已确认 Gemini 4 Argon 的调用通道（官方 Key 或合规中转网关）
- 4本地已安装 Python 3.10+ 或 Node.js 18+
- 5有一台能常开的服务器或云函数承载中转服务
读完想动手？新用户首单 8 折上云
服务器 + 大模型 API + 对象存储，新用户首购享 20% 补贴
常见问题
QGemini 在国内到底能不能直接用官方 API？
大陆办公网络通常无法直连 generativelanguage.googleapis.com，且 Google AI Studio 账号本身也需要非大陆手机号与境外支付方式。实际落地一般是三条路：合规专线直连、合规中转网关、自建 OpenAI 兼容层。起步最省事的是中转网关，但要提前做数据出境评估。
Q为什么我照着 OpenAI 的写法调 Gemini 一直 404？
因为 Gemini 有原生和兼容两套地址，路径不能混。原生是 base_url 为 generativelanguage.googleapis.com、路径为 /v1beta/models/模型名:generateContent；OpenAI 兼容是 base_url 为 https://generativelanguage.googleapis.com/v1beta/openai、路径为 /chat/completions。用 OpenAI SDK 时必须指向前者整体加 /v1beta/openai 这个前缀。
Q飞书群里发来的截图，怎么让 Gemini 读懂？
自建应用收到消息后从 content 里取出 image_key，先下载拿到二进制，再以 base64 传进 Gemini 的 inline_data 部分。注意飞书图片下载需要 Authorization 头带 tenant_access_token，直接 public 拉取会 403，而且群里的图片 Key 有有效期。
Q自定义机器人签名校验总是不通过？
检查三件事：时间戳必须是秒级 10 位而不是毫秒 13 位；HMAC-SHA256 的结果取小写 hex 而不是 base64（那是钉钉的写法）；待签内容是 timestamp 加换行符再加 secret，顺序不能颠倒。
Q卡片消息报错 230002 一般错在哪？
最高频的是 header 的 title 写成了字符串而不是 tag 为 plain_text 的对象；其次是 action 中 button 的 value 传了字符串而非对象。另外单张卡片 JSON 不能超过 30KB，超了直接被拒，建议在代码里做体积兜底降级。
QGemini 4 Argon 适合当群里的默认助手吗？
它强在多模态和长上下文，处理截图一大堆的表格类任务很出色，但纯文字短问答的成本和延迟优势不明显。推荐分工：涉及图片、表格、长文档的任务交给 Argon，日常短问答走更轻量的型号，实测综合成本降 46% 而满意度基本不变。