一、扣子 （Coze） 是什么？能做什么？
扣子 （Coze） 是字节跳动推出的一款 AI Bot 开发平台，不需要用代码也能构建、调试和部署智能体 （Bot） 或工作流。你可以实现从基础对话到复杂任务自动化的全流程 AI 应用开发。以下是具体的操作场景和能力：
Related articles
- 零代码搭建智能体：通过可视化编排设定人设、配置插件和知识库，无需编程即可快速创建具有专业能力的对话机器人。
- 构建自动化工作流：使用拖拽方式设计任务链条，并可在代码节点中用 JavaScript 或 Python 编写自定义逻辑，实现复杂的自动化处理。
- 部署全能 AI 办公助手：让 AI 自主拆解长期任务 （如写竞品报告）、一键生成 PPT 和海报、处理 Excel、将图文转为播客，甚至通过对话直接编程并部署网站。
- 调试与分发：在配置界面右侧，你可以随时与正在搭建的智能体对话，测试效果并即时调整。完成开发后，你可以将智能体一键发布到多个渠道，例如：小米应用商店 （AI 智能体专区）、微信公众号、小程序、企业微信等。
扣子本身主要处理对话逻辑和工作流编排，如果想要智能体具备真正的图像生成、图像识别或视频创作能力，就需要接入专业的视觉生成模型。GrsaiApi 官方提供了——「GrsaiApi——图像生成对话工具」 插件工具，可在扣子插件商店收藏使用。
Grsai API（https://grsai.com com 需要魔法，没有 com 改 Ai 国内直连） 作为国内 AI 大模型 API 源头供应商，提供图片、文本、视频模型生成接口，包括：gpt5.4、gpt5.5、gpt-image-2、Nano banana、Nano banana Pro、Nano banana2、Gemini.... 等模型，支持高并发、失败秒退。模型列表：https://grsai.ai/zh/dashboard/models
通过 GrsaiApi 提供的插件，你的 Bot 可以用最低的价格调用 Grsai API 内所有模型，包含语言、画图、视频。
二、GrsaiApi 扣子插件：GrsaiApi——图像生成对话工具
在扣子中，只需要在插件商店搜索 「GrsaiApi——图像生成对话工具」 插件并收藏，即可使用 GrsaiApi 内置所有模型，有 6 个工具，分为旧版和新版，有什么区别该怎么选择请仔细看接下来的介绍。
1. 新旧版啥区别？
GrsaiAPI 的旧版文档 （https://grsai.ai/zh/dashboard/documents/gpt-image） 中，不同厂商的模型拥有各自独立的接口，例如 GPT-image 模型使用/v1/draw/completions，而 Nano banana 模型则使用/v1/draw/nano-banana。由于接口不统一，调用不同模型需要编写不同的工具代码，导致用户在切换模型时无法快速完成。
- Grsai_Old_NanoBa：支持 GrsaiApi 所有 Nanobanana 模型
- Grsai_Old_image_2：支持 GrsaiApi 所有 Gpt-image-2 模型
- Grsai_Old_Get_Results：支持上述两个模型的异步任务查询
GrsaiAPI 新版文档 （nano-banana 接口 - Grsai API https://qmy27nhsd9.apifox.cn/452392911e0） 采用了统一接口，只需调用 https://{base_url}/v1/api/generate 即可使用平台内除文本模型外的所有图片与视频生成模型。由于新旧文档模型参数不同，异步任务的查询仍需使用新版文档配套的工具。
请注意：新旧版 「Get_Results」 异步查询工具不可混用！
- Grsai_New_All_image（推荐）：支持 GrsaiApi 所有画图/视频模型
- Grsai_New_chat_image：open 格式支持 Grsai 内所有模型 （文本、图片、视频模型；注意图片不支持分辨率选择）
- Grsai_New_Get_Results：异步生成结果查询接口，仅支持使用 「Grsai_New_All_image」 工具并设置了 replyType:"async"参数生成的 id 查询
2. 创建 apiKey
在 GrsaiApi 控制台：https://grsai.com/zh/dashboard/api-keys（com 需要魔法，没有改成 ai 即可访问） 创建 ApiKey，复制使用。请勿泄漏你的 key 给其他人。
填入工具的 apiKey 参数中，注意不要外泄！
3. 收到设置超时时间
建议所有用户在使用的时候将工具异常处理的 「整体执行超时」 超时时间设置在 600s，以免任务还没有生成扣子就返回失败。
4. 不同模型区别
- gemini-2.5-flash-image 对应：
- nano-banana：1-2k 清晰度
- nano-banana-fast：1-2k 清晰度
- gemini-3-pro-image-preview 对应：
- nano-banana-pro（推荐）：1-4k 清晰度高峰期稳定，偶有波动
- nano-banana-pro-cl（推荐）：4k 画质清晰，pro 备用渠道，稳定速度快
- nano-banana-pro-vt：高峰期不稳定，4k 画质清晰
- nano-banana-pro-vip：1-2k 清晰度，付费渠道，稳定但贵
- nano-banana-pro-4k-vip：4k 清晰度，付费渠道，稳定但贵
- gemini-3.1-flash-image-preview 对应：
- nano-banana-2：1-4k 清晰度
- nano-banana-2-cl：1-2k 清晰度
- nano-banana-2-4k-cl：4k 清晰度
- Chatgpt image 2.0 对应：
- gpt-image-2：仅支持 1k 清晰度
- gpt-image-2-vip：支持 1k/2k/4k 清晰度，支持选择质量
渠道不同导致模型版本较多，请按需选择。具体信息看 GrsaiAPi 模型列表：https://grsai.ai/dashboard/mode
5. Grsai6 个扣子工具详细介绍
1.Grsai_Old_NanoBa
- 工具介绍：旧文档接口工具，可使用 GrsaiApi 内所有 nano banana 画图模型
- 支持模型：
- nano-banana-2
- nano-banana-2-cl
- nano-banana-2-4k-cl
- nano-banana-pro
- nano-banana-pro-vt
- nano-banana-pro-cl
- nano-banana-pro-vip
- nano-banana-pro-4k-vip
- nano-banana-fast
- nano-banana
- 输入参数：
- apiKey（必填，控制台复制秘钥 sk-xxx）
- model（必填，模型名称）
- prompt（必填，提示词）
- urls（参考图，支持多图）
- webhook（异步回调填 「-1」 会返回 id）
- aspectRatio（尺寸）
- imageSize（分辨率）
2.Grsai_Old_image_2
- 工具介绍：旧文档接口工具，可使用 GrsaiApi 内所 gpt-image-2 画图模型
- 支持模型：gpt-image-2、gpt-image-2-vip
- 输入参数：
- apiKey（必填，控制台复制秘钥 sk-xxx）
- model（必填，模型名称）
- prompt（必填，提示词）
- urls（参考图，支持多图）
- webhook（异步填 「-1」 会返回 id）
- aspectRatio（尺寸/具体像素值，仅 gpt-image-2-vip 支持 2K、4K 像素值，例如 「2048x2048」）
- quality（质量）
- shutProgress（进度提醒）
3.Grsai_Old_Get_Results
- 工具介绍：旧文档接口工具，异步任务结果查询 （仅支持带有 「Old」 画图工具的异步任务）
- 支持工具：Grsai_Old_NanoBa、Grsai_Old_image_2
- 输入参数：
- apiKey（必填，控制台复制秘钥 sk-xxx）
- id（必填，任务 id）
当你使用旧版画图工具提交异步任务后 （webHook："-1"），用这个工具轮询获取生成结果。
4.Grsai_New_All_image（推荐）
- 工具介绍：旧文档接口工具，可使用 GrsaiApi 内所 gpt-image-2 画图模型，支持同步/流式/异步三种返回模式。
- 支持模型：gpt-image-2、gpt-image-2-vip
- 输入参数：
- apiKey（必填，控制台复制秘钥 sk-xxx）
- model（必填，模型名称）
- prompt（必填，提示词）
- urls（参考图，支持多图）
- replyType（回复类型，支持选择参数）
- json：返回 json
- stream：返回 stream
- async：异步轮询，需要通过 「Grsai_New_Get_Results"查询结果」
- aspectRatio（图像比例/具体像素值，具体像素值仅对 Gpt 模型生效，特别注意 gpt-image-2-vip 的 2K、4K 分辨率需要通过填入对应分辨率像素值，例如 「2048x2048」）
5.Grsai_New_chat_image
- 工具介绍：新接口文档工具，open 格式支持 Grsai 内所有模型 （对话 + 生图 + 视频），通过 「imageurls」 参数可上传图片、视频、文件链接
- 支持模型：
- Chatgpt image 2：
- gpt-image-2
- gpt-image-2-vip
- 香蕉 2：
- nano-banana-2
- nano-banana-2-cl
- nano-banana-2-4k-cl
- 香蕉 pro：
- nano-banana-pro
- nano-banana-pro-vt
- nano-banana-pro-cl
- nano-banana-pro-vip
- nano-banana-pro-4k-vip
- 香蕉 1：
- nano-banana-fast
- nano-banana
- 语言模型：
- gemini-3.1-pro
- gemini-3-pro
- gemini-2.5-pro
- gpt-5.5
- gpt-5.4
- 输入参数：
- apiKey（必填，控制台复制秘钥 sk-xxx）
- model（必填，模型名称）
- messages（必填，提示词）
- imageUrls（参考图，图片/视频/文件链接 （支持多图））
「messages」 需要填入 JSON 内容参考
[
{
"role": "user",
"comtent": [
{
"type": "text",
"text": "组合成一张图片"
}
]
}
]
6.Grsai_New_Get_Results
- 类型：新接口异步结果查询工具，仅查询通过 「Grsai_New_All_image 」 并设置 replyType: "async" 生成的任务
- 支持工具：Grsai_New_All_image
- 输入参数：
- apiKey（必填，控制台复制秘钥 sk-xxx）
- id（必填，任务 id）
通过使用 「GrsaiApi——图像生成对话工具」 插件，你扣子的智能体就能具备图像生成、识别和视频创作等视觉能力。
