核心用法
本技能为 PoYo 平台 Gemini 3 系列模型提供完整的 API 调用支持，涵盖 gemini-3-flash-preview、gemini-3-pro-preview 及 gemini-3.1-pro-preview 三款模型。用户可通过两种端点风格发起请求：OpenAI 兼容的 /v1/chat/completions 格式，或 Gemini 原生 generateContent/streamGenerateContent 格式。技能支持同步与流式响应、多模态提示结构配置，以及 generationConfig 参数精细控制（temperature、topP、maxOutputTokens、stopSequences 等）。执行时需预先设置 POYO_API_KEY 环境变量，推荐在服务器端通过 scripts/submit_gemini_3_api_chat.sh 脚本或参照 references/api.md 构建自定义请求。
显著优点
首先，双格式兼容设计兼顾了开发者习惯与原生特性，OpenAI 兼容格式降低迁移成本，原生格式解锁完整 Gemini 能力。其次，模型选择指南清晰，Flash 侧重速度与代码、Pro 侧重复杂推理、3.1 Pro 为最新预览版，帮助用户快速匹配场景。第三，安全实践规范，文档强制要求密钥服务器端管理，禁止前端暴露，并明确警示日志与截图风险。第四，多模态与流式支持，满足图片输入、实时响应等高级需求。最后，依赖极简，仅依赖系统 curl，无第三方包引入供应链风险。
潜在缺点与局限性
第一，T3 来源可信度，维护者为个人开发者 coolhackboy，无 GitHub 开源记录及社区历史，长期维护与漏洞响应能力存疑。第二，网络调用刚性依赖，所有请求必须发往 PoYo 境外服务器，存在网络延迟、服务中断及跨境合规风险。第三，脚本功能基础，当前 bash 脚本未实现超时重试、指数退避、请求大小校验等生产级机制，高并发场景易失败。第四，隐私告知不足，虽文档提及安全规则，但未明确向终端用户披露对话内容外发至第三方的事实。第五，无 dry-run 模式，无法预览请求内容即直接发送，调试成本较高。
适合的目标群体
- 后端开发者：需快速集成 Gemini 3 能力至自有服务的工程师
- DevOps/运维人员：负责配置服务器端 API 密钥管理与脚本调度
- AI 应用团队：产品已决定采用 PoYo 作为 Gemini 访问渠道，需标准化调用规范
- 技术评估者：希望对比 OpenAI 兼容格式与原生 Gemini 格式差异的架构师
使用风险
性能风险：脚本未设置 --max-time，长耗时请求可能挂死；无重试机制，网络抖动直接导致任务失败。安全与合规风险：T3 来源意味着代码未经广泛审计，需自行审查脚本内容；PoYo 作为第三方平台，数据存储位置、保留期限、删除政策不明，涉及敏感数据需谨慎。依赖风险：功能完全绑定 PoYo 服务可用性，若平台调整接口或终止服务，技能将失效。密钥泄露风险：虽文档强调环境变量管理，但若用户误配置至前端或日志，仍会造成密钥暴露。