SuperAPI AI 工具集

get-images

设计与创作

查看项目

更新于 10-15 23:59

技能介绍

用途:本技能用于配合 Get Images MCP 服务器工作,该服务是托管式图像生成服务,通过一个 MCP 暴露 OpenAI 的 GPT Image 模型和 Google 的 Gemini 图像模型。目标不是单纯调用工具,而是帮助用户得到正确格式、正确位置、符合需求的图像。MCP 接收提示词,返回图像字节和一个短期有效的签名 URL。

主要能力:可用工具有 getimages_generate_image(按提示词生成新图像,计费消耗额度)、getimages_list_images(按最新在前列出此前生成的图像,免费)、getimages_get_image(按 ID 获取单张图像的元数据,可选返回字节,免费)、getimages_get_account(返回 userId、邮箱和额度余额,免费)、getimages_list_usage(返回额度交易历史,免费)。只有生成图像消耗额度。

生成前的四项决策:1)模型,通常需要询问用户,除非上下文已明确或用户已指定;可选模型包括 openai:gpt-image-1.5、openai:gpt-image-2、google:gemini-2.5-flash-image、google:gemini-3.1-flash-image-preview、google:gemini-3-pro-image-preview;成本敏感时默认较便宜选项。2)宽高比,通常可推断,支持 1:1、3:2、2:3、16:9、9:16、4:3、3:4,21:9 仅 Nano Banana Pro 支持;页面横幅常为 16:9,移动启动屏为 9:16,头像或图标为 1:1。3)提示词,用户已给出则直接使用,否则依据上下文草拟并确认。4)存储位置,根据项目技术栈推断,如 Next.js、Vite、Nuxt 用 public/,Astro 用 src/assets/ 或 public/,静态站点用 assets/ 或 images/,移动端用 assets/。

使用方式:需要时可先调用 getimages_get_account 检查额度;调用 getimages_generate_image 传入 prompt、modelId、aspectRatio,支持时传 thinkingLevel;读取结构化响应中的 imageUrl(签名 HTTPS URL,15 分钟过期);下载到目标路径,如 curl -sSfL -o public/coral-hero.png "$IMAGE_URL";若用于网页则运行 python .claude/skills/get-images/scripts/optimize_for_web.py --input public/coral-hero.png --output public/coral-hero.webp --max-width 1920 --quality 82;最后接入代码中的图像引用。

思考级别:仅 google:gemini-3.1-flash-image-preview 和 google:gemini-3-pro-image-preview 接受 thinkingLevel,可选 default 或 deep。deep 更慢更贵,适合多主体、需可读文字或紧凑构图的场景。不支持思考的模型传入该参数会导致服务器错误。

适用场景:网页横幅、博客配图、YouTube 缩略图、社交分享卡、应用图标、社交媒体帖子、电子邮件图形、笔记本测试等。

限制:不静默选择模型;不提供放大端点,需要更多像素时应推荐专用放大工具;不代替用户重试,重试时一次只调整一个变量。额度不足时直接告知余额和充值链接,不重试也不静默换模型。签名 URL 过期时可用 getimages_get_image 并 includeBytes: true 获取新 URL。高级模型生成可能超过 60 秒,客户端不应超时后重试。