一、扣子(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 新版文档(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.不同模型区别
1. gemini-2.5-flash-image 对应:
- nano-banana:1-2k清晰度
- nano-banana-fast:1-2k清晰度
2. 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清晰度,付费渠道,稳定但贵
3. gemini-3.1-flash-image-preview 对应:
- nano-banana-2:1-4k清晰度
- nano-banana-2-cl:1-2k清晰度
- nano-banana-2-4k-cl:4k清晰度
4. 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——图像生成对话工具」插件,你扣子的智能体就能具备图像生成、识别和视频创作等视觉能力。