一、扣子(Coze)是什么?能做什么?
扣子(Coze)是字节跳动推出的一款 AI Bot 开发平台,不需要用代码也能构建、调试和部署智能体(Bot)或工作流。你可以实现从基础对话到复杂任务自动化的全流程 AI 应用开发。以下是具体的操作场景和能力:
- 零代码搭建智能体:通过可视化编排设定人设、配置插件和知识库,无需编程即可快速创建具有专业能力的对话机器人。
- 构建自动化工作流:使用拖拽方式设计任务链条,并可在代码节点中用 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——图像生成对话工具」插件,你扣子的智能体就能具备图像生成、识别和视频创作等视觉能力。