画布是什么
ZPIKA 无限画布是面向客户的可视化工作台,把本站中转的文字 / 图片 / 视频能力接到同一块画布里使用,而不是只靠命令行 / SDK 调 API。
视频生成
固定「视频」分组,默认模型为 Seedance 2.0 Mini,也可选择当前视频 Key 实际返回的其它 Seedance 模型。
图片生成
固定「图片接口(OpenAI 格式)」与「Gemini 画图(原生)」两组,可同时配置;同名 Gemini 模型按默认绑定的渠道决定请求协议。
开通流程
- 注册账号 打开 https://canvas.zpika.com/ 完成注册 / 登录。
- 通知管理员审核 把注册使用的账号(用户名 / 邮箱等)发给管理员邮箱 [email protected],等待审核通过。
- 打开「配置与用户偏好」 审核通过后,在渠道模式中选择自定义渠道。界面已锁定 4 个固定分组,无需再手写 Base URL 或协议。
-
按分组填写 Key 并拉取模型
先在 ZPIKA API 密钥页面按用途创建 Key:文字 Key 选择文字模型分组;「图片接口(OpenAI 格式)」Key 可拉取 GPT Image 与采用 OpenAI Images 格式的 Gemini 图片模型;「Gemini 画图(原生)」用于仍支持
generateContent的原生渠道;视频 Key 选择seedance分组。把 Key 填入对应预设分组,再逐组点「拉取模型」。同一把 Key 若同时支持两种 Gemini 协议,也可以分别填入两个图片分组。 - 同一画布一起用 四个分组可以同时保存;配置完成后,同一块画布即可同时使用文字生成、OpenAI Images 图片生成、Gemini 原生图片生成和 Seedance 视频生成。
直连域名说明
当前画布已配置 [直连域名]。用户侧一般不用改;如需在其它客户端直接调用,请单独联系站长获取。
| 地址 | 用途 |
|---|---|
[直连域名] |
文字 / 音频请求、模型列表拉取与生成请求 |
当前画布会自动使用已配置的直连域名;无需手动填写内部路由信息。
如何配置分组
审核通过后,进入画布 配置与用户偏好:
- 渠道模式选自定义渠道(需管理员已开启普通用户自定义渠道权限)。
- 在分组下拉里切换:文字 / 图片接口(OpenAI 格式) / Gemini 画图(原生) / 视频。
- 在 ZPIKA API 密钥页面按文字、图片、Gemini 原生、Seedance 视频用途创建 Key,并在创建时选择对应模型分组;同一把图片 Key 只有在确实同时支持 OpenAI Images 与 Gemini 原生协议时才填入两个图片分组。
- 逐组填写 Key 并点击拉取模型:画布会通过本站固定域名读取这把 Key 真正可用的模型,并按当前分组过滤。
- 画布只会从实际返回结果中自动勾选推荐模型;图片接口允许 GPT Image 与 Gemini 图片模型并存,Gemini 原生分组只保留原生图片模型,Seedance Key 不会被额外塞入 Veo。
- 在下方「默认生图 / 视频 / 文本 / 音频渠道与模型」确认绑定(显示为「分组名 / 模型名」)。
至少完整配置一个分组(Key + 已选模型)后才能使用自定义渠道;四组都配置后,才能在同一画布完整使用文字、两类生图和视频能力。更换某组 Key 后需要重新点击「拉取模型」,避免继续使用旧 Key 的模型列表。
四个固定分组
界面分组名固定如下(与中转站套餐 Key 对应关系请找管理员确认):
| 画布分组 | 能力 | 协议 | 直连地址 | 推荐模型(拉取后优先自动勾选) |
|---|---|---|---|---|
| 文字 | 文本 / 音频 | OpenAI 兼容 | [直连域名] |
gpt-5.6-terra、gpt-5.6-sol、gpt-5.6-luna |
| 图片接口(OpenAI 格式) | GPT Image 与 Gemini 图片生成 / 编辑 | OpenAI 兼容 | [直连域名] |
gemini-3.1-flash-image-preview、gpt-image-2.6、当前 Key 返回的其它图片模型 |
| Gemini 画图(原生) | Gemini 原生生图 | Gemini 原生图片 | [直连域名] |
gemini-3.0-pro-image、gemini-3.1-flash-image(不带 preview) |
| 视频 | Seedance 视频生成与参考素材控制 | OpenAI 视频任务兼容 | [直连域名] |
doubao-seedance-2-0-mini-260615、其它当前 Key 可用的 Seedance 模型 |
配置示例(同一画布)
1) 文字
API Key:sk-你的文字套餐Key
推荐模型:gpt-5.6-terra ...
2) 图片接口(OpenAI 格式)
API Key:sk-你的图片接口套餐Key
推荐模型:gemini-3.1-flash-image-preview / gpt-image-2.6 / 其它当前 Key 可用模型
3) Gemini 画图(原生)
API Key:sk-你的 Gemini 原生套餐Key
推荐模型:gemini-3.0-pro-image / gemini-3.1-flash-image
4) 视频
API Key:sk-你的 seedance 分组Key
推荐模型:doubao-seedance-2-0-mini-260615 / 其它当前 Key 可用的 Seedance
请按 Key 实际授权的用途选择对应分组;拉取模型后,以画布显示的模型列表为准。画布不再接受手工输入未被当前 Key 拉取到的模型名。
默认生成参数
配置升级后,画布侧默认值如下(浏览器里残留的旧官方默认会一次性纠正):
- 图片:默认
4K+9:16+ 1 张 - 视频:默认
Seedance 2.0 Mini+480p+5s+16:9,默认生成声音 - 默认绑定:生图默认「图片接口(OpenAI 格式)」中的
gemini-3.1-flash-image-preview;视频默认视频分组;文本 / 音频默认文字分组
生成时仍可在节点面板里改分辨率、比例、张数与模型。
async: true:先得到任务 ID,再查询 GET /v1/images/generations/{task_id} 或 GET /v1/images/edits/{task_id}。Gemini 原生分组使用另一套协议。
画布怎么操作
画布的基本思路是:先把素材放上去,再用连线告诉系统“这个素材要拿来做什么”。图片、视频、文字可以在同一个画布里串起来。
- 从电脑直接拖入图片或视频 在文件管理器中选中本地图片或视频,直接拖到浏览器里的画布空白处。松开后会生成对应素材节点,不需要先上传到图床或复制链接。
- 从素材节点拉出一根线 把鼠标移到图片、视频或文本节点的连接点,按住并拖到画布空白位置后松开。此时会出现创建菜单。
- 选择要生成的内容 在菜单里选择图片生成、视频生成或文本生成。系统会创建新节点,并自动把刚才的素材连到这个任务上。
- 写提示词并开始生成 在新节点或生成配置中输入想要的效果,确认模型和参数后开始生成。上游连接的图片/视频会作为参考素材参与本次生成。
-
在提示词里用 @ 指名引用素材
在提示词输入框键入
@,会出现当前任务已连接资源的候选项,例如图片1、视频1。点击或用方向键选中后,继续写说明即可,例如“让 @图片1 中的产品在 @视频1 的场景里旋转展示”。 - 继续往下连 结果生成后还可以再次拉线。例如先用图片生成概念图,再连到视频生成;或者先生成文字脚本,再接到图片、视频任务中使用。
@ 候选。建议先把素材整理好,再从需要作为“源头”的节点拉线,后续修改和重试会更清楚。
常用:图片 → 视频
拖入产品图,拉线选择“视频生成”,写运动、镜头和场景描述,即可把图片作为视频参考。
常用:文字 → 图片
先生成或写好文案,再从文本节点拉线选择“图片生成”,让文字内容成为画面的提示词来源。
常用:@图片 / @视频
连接好素材后,在提示词里输入 @ 选中图片或视频,明确告诉模型每个素材在本次生成中要承担什么作用。
画布 + Seedance 视频
- 配置视频分组先在 ZPIKA API 密钥页面创建 Key 并选择支持目标模型的分组;使用统一 Seedance 报价时通常选择 seedance。把 Key 填入画布视频分组,拉取并勾选模型;默认使用
doubao-seedance-2-0-mini-260615。 - 连接参考素材把图片、视频或音频拖进画布,从素材节点拉线并选择“视频生成”。
- 使用 @ 明确引用在提示词中输入
@,选择后会保留为@图片1、@视频1、@音频1标签。出现任意@时只发送明确引用的素材;没有@时发送该任务全部已连接素材。 - 自动转换素材角色普通图片、视频、音频会分别转换为
reference_image、reference_video、reference_audio。参考视频必须同时连接并引用至少一张普通参考图片。当前使用 Seedance 2.5 时,在@菜单选择图片后还可指定“参考图 / 首帧 / 尾帧”,首尾帧会转换为first_frame/last_frame。可以只选首帧;尾帧必须搭配首帧,且首尾帧不能混用普通参考素材。2.5 使用自适应比例,同时提供首尾帧时两张图片必须像素尺寸一致。2.0 满血、Fast、Mini 当前使用普通参考图。 - 按模型限制数量Seedance 2.0 满血、Fast、Mini 最多使用 9 张图片、3 个视频、3 个音频,合计 15 项;Seedance 2.5 最多使用 30 张图片、10 个视频、10 个音频,合计 50 项。超过限制时画布会在选择或提交前提示,不会静默截断。
- 确认输出参数默认 Mini、480p、5 秒、16:9、有声音;比例选项会显示对应像素尺寸。
- 等待回填任务会显示生成进度,完成后经过服务器下载、浏览器下载和本地保存,再自动回填到画布。任务未完成时中断可“继续查询”;确认完成后取回超过 5 分钟可“重新下载”,两者都不会重新生成。也可在 ZPIKA 任务日志查看 Seedance 进度、制品和下载入口。
Seedance 客户价格总体约为官方公开价格的 8.0-8.5 折,不同渠道和模型略有差异。Mini 480p 约 ¥0.10-0.20/秒,默认 5 秒无参考视频通常约 ¥0.5-1.0。以上价格仅供参考,可能随时波动,以站点实际定价和任务结算为准。
在同一画布一起使用
- 先把需要的分组填好 Key 并拉取模型,再在画布创建节点 / 任务。
- 可用图片接口(OpenAI 格式)中的 Gemini 或 GPT Image 出概念图,再把结果作为视频分组中 Seedance 的参考素材。
- 普通参考图优先使用图片接口(OpenAI 格式),由画布上传并提交 URL;只有需要 Base64 参考图时才切到Gemini 画图(原生),并使用不带
preview的模型名。两种协议可以并存。 - 视频任务走 视频 分组,与画图分组互不覆盖。
- 文字助手 / 文本节点走 文字 分组。
API 细节仍可参考:
常见问题
注册后立刻用不了?
需要管理员审核。请先邮件联系 [email protected],并提供你的注册账号信息。
可以只配视频、不配图片吗?
可以。只填「视频」分组的 Key 并选好模型即可;其它分组可留空(显示为未配置 Key)。
为什么视频分组没有 Veo?
Veo 当前暂不接入,视频生成请使用 Seedance。视频分组只展示当前 Key 实际返回的视频模型,不会额外补入其它模型。
为什么没有「新增渠道 / 改 Base URL」?
当前画布已预设直连地址与 4 个固定分组,避免填错地址或协议。只需按分组填 Key 并拉取模型。
Key 填错分组会怎样?
通常会鉴权失败、无可用模型或 401/403。请确认该 Key 对应中转站套餐,是否覆盖该分组推荐模型。
拉取模型成功但生成失败?
画布会自动使用已配置的 [直连域名]。请确认 Key 对应的套餐与模型分组正确;仍无法生成时请联系管理员。
画布和直接调 API 有什么关系?
画布是可视化入口;底层仍走中转站网关。需要程序化接入时,直接看本站各 API 文档即可。