SuperAPI AI 工具集

invoking-gemini

设计与创作

查看项目

更新于 10-16 02:35

技能介绍

用途:在 Gemini 相比 Claude 更有优势时把任务委派给 Google Gemini,涵盖图像生成、语音合成(TTS)、结构化输出、多模态任务与成本优化(并行批处理、高并发简单任务)。

主要能力:

  • 图像生成:generate_image() 生成插画、博客头图、示意图,支持风格前缀、构图描述、文字渲染,模型别名 nano-banana-2(快)与 image-pro(质量/文字渲染)。
  • 语音合成:generate_speech()、design_voice()、list_voices(),支持逐行风格、从文字描述设计音色、双人对话;输出 WAV 24kHz 单声道,带 SynthID 水印。
  • 结构化输出:invoke_with_structured_output() 配合 Pydantic 模型,保证 JSON Schema 与字段顺序;嵌套模型会自动内联。
  • 文本与多模态:invoke_gemini() 支持 image_path 输入,invoke_parallel() 并行批量。

使用方式:安装 uv pip install requests pydantic;凭证可选 Cloudflare AI Gateway(/mnt/project/proxy.env 中 CF_ACCOUNT_ID、CF_GATEWAY_ID、CF_API_TOKEN)或直连(GOOGLE_API_KEY.txt、API_CREDENTIALS.json)。脚本路径 /mnt/skills/user/invoking-gemini/scripts,导入 gemini_client。

限制:Gemini 3.x 使用字符串 thinking_level(minimal/low/medium/high);3.7/3.8 Flash 拒绝 minimal,客户端降级为 low;输出预算不足会导致 JSON 截断并报 Pydantic 解析错误;语音模型可能改动词句,需 ASR 校验;语音克隆未接入且在部分区域不可用;Pro 层不再路由,pro 别名解析到 gemini-3.8-flash。失败时返回 None,需检查凭证或重试。