一、扣子（Coze）是什么？能做什么？

扣子（Coze） 是字节跳动推出的一款AI Bot 开发平台，不需要用代码也能构建、调试和部署智能体（Bot）或工作流。你可以实现从基础对话到复杂任务自动化的全流程AI应用开发。以下是具体的操作场景和能力：

• 零代码搭建智能体：通过可视化编排设定人设、配置插件和知识库，无需编程即可快速创建具有专业能力的对话机器人。

• 构建自动化工作流：使用拖拽方式设计任务链条，并可在代码节点中用JavaScript或Python编写自定义逻辑，实现复杂的自动化处理。

• 部署全能AI办公助手：让AI自主拆解长期任务（如写竞品报告）、一键生成PPT和海报、处理Excel、将图文转为播客，甚至通过对话直接编程并部署网站。

• 调试与分发：在配置界面右侧，你可以随时与正在搭建的智能体对话，测试效果并即时调整。完成开发后，你可以将智能体一键发布到多个渠道。

扣子本身主要处理对话逻辑和工作流编排，如果想要智能体具备真正的图像生成、图像识别或视频创作能力，就需要接入专业的视觉生成模型。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....等模型，支持高并发、失败秒退。模型列表：

通过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.ai/zh/dashboard/documents/gpt-image​（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模型列表：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",
    "content": [
      {
        "type": "text",
        "text": "组合成一张图片"
      }
    ]
  }
]

6.Grsai_New_Get_Results

类型：新接口异步结果查询工具，仅查询通过“Grsai_New_All_image ”并设置 replyType: "async" 生成的任务

支持工具：Grsai_New_All_image

输入参数：

• apiKey（必填，控制台复制秘钥sk-xxx）

• id（必填，任务id）

通过使用「GrsaiApi——图像生成对话工具」插件，你扣子的智能体就能具备图像生成、识别和视频创作等视觉能力。