ZOOOP 快速入门：把图像、视频、音频模型收进一张无限画布

这是什么？适合谁？

ZOOOP（zooop.ai）是一个浏览器内的 AI 创作平台，定位写在自己首页上：AI-native Creative Platform。它自己不做模型，做的是聚合与工作台——把图像、视频、音频三类生成能力收进一个账号、一套积分、一张无限画布，再加一批「填好参数的模板」和「一键工具」。

按官方 FAQ 与首页分区，它提供三种使用形态：

• 无限画布（Generative Canvas）：在浏览器里把生成物铺开、连线、迭代，支持多人实时同屏协作与角色权限；
• 专用工具页：把最常用的单点操作单独做成页面——背景移除、放大、局部重绘、老照片修复、换装、换发型、证件照、风格迁移等（首页「AI Tools」分区的完整清单）；
• 模板：把提示词与参数打包成开箱即用的起点，比如「圣诞头像」「宠物万圣节肖像」「Instagram 造型集」，模板页会显示使用次数（首页热门模板从个位数到 2k 都有）。

模型覆盖面是它最主要的卖点。官方 FAQ 与首页列出的包括：图像侧 GPT Image 2.6、Nano Banana 2.1、Seedream 5.5、Midjourney V8.2、Meta Muse Image、Flux 2、Grok Imagine；视频侧 Seedance 2.5、Gemini Omni 1.2 Flash、MiniMax H3、Kling V4、Wan 3.0、Vidu Q4；语音与音乐侧 ElevenLabs、Gemini TTS、MiniMax、Google Lyria 3、Qwen3-TTS、Inworld、Index TTS。这些是官方自述的清单，模型可用性与版本会随时变，以你登录后页面里实际能选的为准。

适合谁：需要在一个地方横向比较多个模型出片效果的创作者；做社媒短视频、模板化内容、批量头像与商品图的小团队；要把生成能力接进自己脚本或内部工具的开发者（它有公开 API 与 CLI）；不想自己配环境、能接受按积分付费的人。

不适合谁：要求「生成内容必须能取得著作权保护」的商用场景（服务条款明确不保证可保护性，见下文）；需要私有化部署或数据完全不出网的人；对「积分不可退款、订阅积分按月清零」这类计费方式敏感的人；只要一个模型、且已经能直接用官方 API 的人（多一层聚合就多一层成本）。

核验日期：2026-11-13。本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。

前置准备

• 账号。官方条款写明支持通过第三方账号（Google、Microsoft、X）或邮箱 magic link 注册。条款要求使用者年满 18 岁并具备完全民事行为能力。
• 支付方式。按定价页 FAQ，付款走 Stripe，支持主流信用卡与借记卡。国内用户要提前确认自己的卡能不能过 Stripe。
• 先想清楚「用量形态」再选付费方式，这直接决定你的单位成本：
  • 偶尔用（一个月做几条）：买积分包。官方明确「积分包里的积分永不过期」。
  • 每周都用：订月度套餐。Basic $9/月给 1,000 积分，Pro $19–$59/月给 2,000–6,000 积分，Max $79–$119/月给 8,000–12,000 积分；年付再省 10%（Basic）、15%（Pro）、20%–30%（Max）。
• 团队场景：免费团队最多 20 名成员，其中 10 个免费创作者席位，其余位置可以给只能浏览与下载的观看者（观看者不占创作者席位、不花钱）。要更多创作者席位才需要 Pro：每个付费席位 $15/月，每个付费席位每月往团队共享积分池里放 1,000 积分，同时解锁更高并发、500 人上限与优先支持。
• 存储额度：每个用户每月 5 GB 免费云存储用于 AI 生成的图像、视频、音频；超出按用量计费，未用完的免费额度不结转。
• 如果是开发者路线：准备一个能跑 npx 的 Node 环境，或者一个能发 HTTPS 请求的 shell。API key 从网页端签发，形如 zpk_live_…。

启用与接入

路径 A：网页端（零安装，先走这条）

打开 https://zooop.ai/，注册登录。新账号会拿到初始赠送积分（官方 FAQ 说「每个新账号注册时获得 starter credits」，但没有在公开页面写具体数额），先用它把「一张图」和「一段视频」各跑一次，再决定买哪种套餐。

路径 B：CLI（把生成搬进终端与脚本）

官方 CLI 用设备码登录（OAuth 2.0 device authorization grant，RFC 8628），不需要手动复制 key：

npx zooop login     # 打开 https://zooop.ai/cli/login?code=XXXX-XXXX，核对代码后点 Authorize
npx zooop whoami    # 确认当前身份、积分归属与项目

登录成功后这个「安装实例」会拿到一把普通 API key（格式 zpk_live_…），有效期可选 30 / 90 / 365 天。同一台机器重复登录会替换掉上一次的 key，不会堆积；zooop logout 会在服务端吊销这把 key 并删掉本地副本。

常用操作：

npx zooop templates --type video                              # 列出视频模板
npx zooop run --template superhero-movie-poster \
  -p 'image_urls=["@./me.jpg"]' --out ./results               # 用模板跑一次，产出落到 ./results
npx zooop tasks                                               # 看历史任务与状态

在 CI 或没有浏览器的服务器上，跳过登录直接设环境变量即可——ZOOOP_API_KEY 的优先级高于登录态：

export ZOOOP_API_KEY="zpk_live_..."

路径 C：HTTP API（自己写集成）

Base URL 是 https://zooop.ai/api/public/v1，认证用 Bearer：

curl -s https://zooop.ai/api/public/v1/models \
  -H "Authorization: Bearer $ZOOOP_API_KEY"

创建一次生成任务的形态是「先查模型拿 interfaceId 与 versionId，再 POST /tasks」：

curl -X POST https://zooop.ai/api/public/v1/tasks \
  -H "Authorization: Bearer $ZOOOP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-unique-key-123" \
  -d '{
    "interfaceId": "your-model-interface-id",
    "versionId": "your-model-version-id",
    "params": { "prompt": "a cinematic shot of a city at night" }
  }'

拿到 taskId 后轮询：

curl -s "https://zooop.ai/api/public/v1/tasks/<TASK_ID>" \
  -H "Authorization: Bearer $ZOOOP_API_KEY"

status 会经历 queued → running → succeeded/failed/cancelled，只有后三个是终态。成功时 outputs 数组里是结果资产（部分模型会返回多条），失败或取消时 creditsCharged 为 0（已退回）。

其他可用端点：POST /quote（先算这次要花多少积分）、POST /uploads（上传素材）、GET /templates、GET /ai-tools、POST /describe-image、GET /me（含实时限额）。注意：任务里的媒体 URL 必须托管在 zooop.ai 上，外部地址会返回 400 foreign_url，所以要先 POST /uploads 拿 UPLOAD_ID 再引用。

第一个完整任务：用模板出一条 5 秒片子，再用 API 复现一次

目标是把「网页能用」升级成「我能用接口重复它」——这是判断你是否该把它接进工作流的最短路径。

1. 网页端跑模板。 打开 https://zooop.ai/templates，挑一个接近你目标的视频模板（模板已经把模型、参数、时长、画幅配好，是「已知能跑通」的起点），上传一张自己的人像或宠物照作为输入，生成一条最短时长的片子。这一步的目的是确认：积分扣了、任务跑完了、产物能下载。

2. 记录这次消耗。 在账户的积分记录里看这次扣了多少积分。这个数字是后面所有成本估算的基准——官方的计费规则是「不同功能、模型、分辨率、时长消耗不同积分」，公开页面没有一张统一的单价表，所以只能自己测。

3. 换成 API 复现。 先查模型清单，找到刚用过的那个模型：

   curl -s https://zooop.ai/api/public/v1/models \
     -H "Authorization: Bearer $ZOOOP_API_KEY" | head -c 2000
   

   再查模板清单，确认模板的 slug 与参数：

   curl -s https://zooop.ai/api/public/v1/templates \
     -H "Authorization: Bearer $ZOOOP_API_KEY" | head -c 2000
   

4. 先报价，再提交。 用 POST /quote 把参数发过去，拿到预估积分；确认能接受再 POST /tasks。这一步能避免「参数写错、跑完才发现很贵」。

5. 轮询到终态，下载产物。

   curl -s "https://zooop.ai/api/public/v1/tasks/<TASK_ID>" \
     -H "Authorization: Bearer $ZOOOP_API_KEY"
   

   status 变成 succeeded 后，从 outputs[].url 取结果。

预期结果与成功判据：

• 网页端与 API 两次调用产生同类型的产物（视频文件可播放，或图像可打开）；
• GET /me 返回的积分余额变化量，与两次任务的 creditsCharged 之和一致；
• POST /tasks 带上相同的 Idempotency-Key 重放时，响应里 idempotent: true，不会重复扣费。

这一步的常见非故障：任务返回 422 moderation_blocked。官方说明这是内容策略在扣费前就拦下了，不扣积分——通常是提示词或参考图里有人像、品牌、暴力元素。改写提示词再试，不是接口坏了。

初级用法

1）用模板起步，别从空白提示词开始

模板已经把模型、参数、时长、画幅都调好了，是「已知能跑通」的起点。用法是：选一个接近你目标的模板 → 生成一次 → 在画布上把它的参数抄下来改成自己的提示词。这比从零试参数快得多，也更容易判断问题出在提示词还是模型能力。

2）在无限画布上做「同题材横向比较」

这是聚合平台最值钱的功能：同一个提示词，分别用两三个图像或视频模型各跑一次，产物并排摆在画布上。看过差异再决定长期用哪个模型，而不是凭榜单选。注意这会成倍消耗积分——先在低分辨率或最短时长下比，选定后再出正式版。

3）专用工具页处理「不需要生成」的活

背景移除、放大、局部重绘、老照片修复、换装、证件照这些在「AI Tools」里有独立页面。它们的定位是不需要你写提示词的一键处理：工具页已经把参数预设好，你传图、选工具即可，不是让你从空白提示词开始配模型。做电商图、头像、素材清洗时优先走工具页，别用生成模型硬做。每次调用消耗多少积分没有公开单价表，只能看积分记录，或用 POST /quote 先算。

4）用「收藏」和「项目」把素材管起来

官方强调可以星标、分组、回看每次生成，并且项目与画布数量不设上限。养成习惯：一次实验一个项目，满意的产物加星标。否则两周之后你会在一堆相似产物里找不到那张能用的。

高级玩法

1）CI 里用 ZOOOP_API_KEY + Idempotency-Key 做幂等批处理

线上系统最怕「网络超时后重试，结果扣两次钱」。官方的幂等设计正好解决这个：给每个业务任务生成稳定的 key（比如内容 ID 的哈希），重试时带上同一个 Idempotency-Key，命中已有任务时响应里会出现 idempotent: true 并返回该任务当前状态，而不是新建一个。配合 POST /quote 先算价，就能做出「有预算上限的批量生成」。

2）按接口给的限额设计并发，别靠重试硬顶

官方按 key、按 60 秒窗口限流：POST /tasks 与 POST /tasks/{id}/cancel 是 60 次/分钟，POST /uploads 是 30 次/分钟，读取类（GET /tasks、GET /uploads/{id}、GET /me、POST /quote、GET /ai-tools、GET /templates）各 120 次/分钟，POST /describe-image 是 10 次/分钟；GET /tasks/{id} 与 GET /models 没有固定上限。超限返回 429，读 Retry-After 再重试——盲目指数退避只会撞更多次。

3）用 error.code 分流，而不是看 HTTP 状态码

官方给了一套机器可读错误码，分流逻辑写对了能省掉大量人工排查：402 token_daily_cap_exceeded 是这次任务会把这把 key 推过每日上限（响应里带 error.spent、error.cap、error.cost），429 token_daily_cap_reached 是当天额度已经用完（带 error.spent、error.cap）——两者含义接近但状态码不同，别只按 402 分流；402 team_subscription_inactive / viewer_seat 是团队订阅失效或席位不能生成，403 team_banned 是团队被封禁；422 moderation_blocked 是内容策略拦截（扣费前）；422 aspect_ratio_unsupported / video_too_long / too_short / text_too_long 是参数不匹配模型；429 rate_limited 是限流；503 pricing_misconfigured / vision_unavailable / moderation_unavailable 是服务端临时问题，该重试。

4）用 GET /me 的 limits 做容量监控

GET /me 会返回这把 key 的实时限额与用量。把它接到你的监控里，「积分快用完」和「当天要撞上限」都能提前知道，而不是等 402 / 429 炸在用户请求上。

5）自己实现设备码登录，把 ZOOOP 接进内部工具

POST /api/public/v1/cli/device 与 POST /api/public/v1/cli/token 就是标准 RFC 8628 设备授权流程，官方明确说「所以你可以用同样的方式给自己的工具做登录」。流程是：申请设备码（expiresIn 600 秒、interval 5 秒）→ 让用户在 https://zooop.ai/cli/login 输入 userCode 并授权 → 你用 deviceCode 轮询换 key。轮询期间会返回 authorization_pending（继续）、slow_down（间隔加 5 秒）、access_denied（用户拒绝，停止）、expired_token（超时，重新开始）。这样你的内部工具不需要让用户手工粘贴 key。

小技巧

1. 先算价再提交。 POST /quote 是免费的读取类端点（120 次/分钟），用它能避开「参数写错跑出天价任务」。批量场景下这一步应该成为硬性前置。
2. 视频先测最短时长。 视频按分辨率与时长消耗积分，公开页面没有统一单价表；先用最短时长、最低分辨率确认构图与动作方向对不对，再出正式版。一次性出高清是最常见的浪费。
3. 媒体必须先上传到 zooop.ai。 直接丢外部 URL 会拿到 400 foreign_url。要引用本地图，CLI 用 @./file.jpg 的写法，API 先 POST /uploads。
4. 模板折扣只在「用订阅积分支付的那部分」生效。 官方的规则是：套餐折扣只作用于订阅积分支付的部分，用积分包支付的部分按原价。所以想让折扣最大化，就在每月额度内先花订阅积分（系统本来也是先扣订阅积分）。
5. 积分包和订阅积分的过期规则完全不同。 积分包永不过期，订阅积分月末清零、不结转。有大额一次性需求时买积分包；稳定高频才订套餐。
6. 注销前先把积分花掉或把文件导出来。 官方隐私政策写明：提交注销即放弃剩余积分余额、不予退款；订阅当期费用不退；冷却期 7 天内重新登录可撤销。

进阶学习路径

1. 首页 FAQ —— https://zooop.ai/，先用它把「支持哪些模型」「免费层怎么算」「团队与席位怎么算」「生成内容能不能商用」四个问题搞清楚。
2. 定价页 —— https://zooop.ai/pricing，套餐档位、积分数量、年付折扣、模板折扣、退款与存储计费规则都在这里，是唯一的公开计价依据。
3. API 文档 —— https://zooop.ai/api-docs，端点、参数、错误码、限流表与设备码流程的完整定义。写集成前先通读「错误码」一节，能省掉一半联调时间。
4. CLI 指南 —— https://zooop.ai/cli，登录、模板、运行、任务查询的完整命令示例。
5. 服务条款 —— https://zooop.ai/terms-of-service，第 4 节（积分与计费）、第 5 节（用户内容与知识产权）、第 6 节（AI 生成内容特别说明）、第 7 节（可接受使用）是商用前必读的四节。
6. 隐私政策 —— https://zooop.ai/privacy-policy，数据收集范围、共享对象、注销流程与保留期限。
7. 模板库与模型库 —— https://zooop.ai/templates 与 https://zooop.ai/models，用使用次数和模型清单判断「现在社区在用什​么」，比看宣传页准。

踩坑记录

症状：任务提交成功但立刻 failed，creditsCharged 为 0。 原因：多数是参数不匹配模型——422 aspect_ratio_unsupported、video_too_long / video_too_short、text_too_short / text_too_long、too_many_items / too_few_items。也有可能是 503 pricing_misconfigured 这类服务端临时问题。 解决：看 error.code 而不是只看状态。参数类的换模型或改参数；503 类等一会儿重试。

症状：400 foreign_url。 原因：params 里的媒体 URL 不在 zooop.ai 上。官方要求先把素材上传到平台。 解决：API 先 POST /uploads 拿 UPLOAD_ID 再在参数里引用；CLI 用 @./local-file.jpg。

症状：422 moderation_blocked，而且看起来没扣钱。 原因：内容策略在扣费前拦截，触发原因通常是提示词或参考图里涉及真人形象、品牌标识、暴力或性化内容。 解决：改写提示词、换参考图。如果是「真人换脸」类需求，先对照条款第 7 节——深度伪造用于欺诈、诽谤、欺骗是明确禁止的。

症状：批量脚本跑到一半开始大量 429。 原因：撞上了按 key、按 60 秒窗口的限流（POST /tasks 60 次/分钟，POST /uploads 30 次/分钟）。 解决：读响应里的 Retry-After 等待，同时把并发压到限额以下；不要用固定退避硬顶。

症状：重试之后同一段内容被扣了两次积分。 原因：没有用幂等键，重试被当成新任务。 解决：给每个业务任务生成稳定的 Idempotency-Key（内容 ID 哈希即可），重试时复用同一个；响应里 idempotent: true 表示命中已有任务。

症状：订阅了套餐，模板折扣却没生效。 原因：折扣只作用于「用订阅积分支付的那部分」，用积分包支付的部分按原价；另外订阅积分每月清零，用完就转去扣积分包。 解决：把主要消耗安排在订阅积分额度内。要判断某次到底扣的是哪种积分，看账户的积分流水而不是总额。

症状：想注销账号，发现剩余积分和当期订阅费都拿不回来。 原因：条款与隐私政策都写明积分不可退款、当期费用不退、注销即放弃剩余余额。 解决：注销前先把积分用掉、把作品导出。冷却期 7 天内重新登录可以撤销注销请求。

常见问题

Q：ZOOOP 是什么？它自己有模型吗？ A：官方定义是「AI-native creative platform」：在浏览器无限画布上生成图像、视频、音频，也可以用单点工具页做抠图、放大这类具体工作，或者直接用模板。它自己不做模型，而是集成各家第三方模型；官方也明确说「具体功能与可用模型会不时变化」。

Q：有没有免费额度？ A：有，但边界要说清：新账号注册时送一组 starter credits；积分包里买的积分永不过期；每个用户每月有 5 GB 免费云存储给 AI 生成的图像、视频、音频用，超出按用量计费且未用完不结转。官方没有在公开页面写 starter credits 的具体数额，所以不要按某个数字做计划。

Q：生成的内容能商用吗？版权归谁？ A：条款 5.2 写的是：在适用法律允许的最大范围内，你拥有生成内容，可以用于个人或商业目的，账号状态正常时平台不主张所有权。但条款 6 同时给了三条限制：生成内容可能还受第三方模型供应商的使用条款约束；AI 输出是概率性的，平台不保证唯一性；在部分司法辖区，纯粹由 AI 生成、缺乏足够人类创造性投入的内容可能不受著作权保护，平台对此不作保证。所以商用前要自己判断「人类创作投入」够不够，并核对具体模型的条款。

Q：平台会不会拿我的内容训练模型？ A：条款 5.3 写明：未经你单独明确同意，不会用你的输入内容或生成内容训练或微调模型（包括第三方的模型）。同时 5.4 给了一个仅限「存储、传输、展示、备份、内容审核、技术支持」目的的全球非独占免费许可，删除内容或注销账号后终止。

Q：积分怎么算？为什么会话一次和一次价格差很多？ A：官方规则是「不同 AI 功能、模型、分辨率和时长消耗不同积分」，具体数额以「平台上当时发布的计费规则」为准，公开定价页没有统一单价表。所以唯一可靠的做法是自己测：用 POST /quote 报价，或在网页端跑一次后看积分流水。模板折扣（10% / 15% / 20%）只作用于订阅积分支付的部分。

Q：能退款吗？ A：定价页 FAQ 与条款 4 都写明：积分属于数字商品，购买后不可退款；月度或年度订阅可随时取消，取消后当期继续有效到期满，当期费用不退。官方自己的建议是「先小量试」。

Q：数据存在哪里？能删干净吗？ A：隐私政策写的是数据存在安全的云服务器、用户生成内容放在 S3 兼容的对象存储。注销是自助的：用户中心 → Profile → Danger zone 提交后账号立即锁定，进入 7 天冷却期（期间重新登录可撤销），期满后永久删除姓名、邮箱、头像、注册 IP、推荐码以及全部上传文件、画布与个人项目，邮箱替换为匿名标识。但 Stripe 的支付订单与积分流水会以匿名形式保留 7 年以满足税务、会计与反欺诈义务。

权限、隐私、成本与平台限制

权限与账号：账号通过 Google / Microsoft / X 或邮箱 magic link 登录；团队有角色与权限体系，创作者能提交任务、编辑画布、消耗团队积分，观看者只能浏览与下载。账号不可转让、出借。

隐私：收集账号信息、使用数据（AI 任务记录、积分流水）、你上传与生成的内容、Stripe 处理的支付信息（平台只保留订单与订阅记录，不存完整卡号）、以及 IP、浏览器、设备与 Cookie 等技术数据。共享对象包括 Stripe、身份提供方、以及用于内容生成的 AI 模型供应商；官方声明不出售个人信息，用户内容存在 S3 兼容对象存储，并用 Google Analytics 做站点分析。跨境传输按适用数据保护法处理。

成本：积分制。公开价目为订阅 Basic $9/月（1,000 积分）、Pro $19–$59/月（2,000–6,000）、Max $79–$119/月（8,000–12,000），年付分别再省 10% / 15% / 20%–30%；团队 Pro 付费创作者席位 $15/席/月，每席每月 1,000 积分进共享池。单次生成的积分消耗没有公开单价表，必须自己测。积分不可退款，订阅积分月末清零。

平台限制：仅浏览器/SaaS，无私有化部署；年满 18 岁；内容审核可能拦下有真人形象、品牌或敏感题材的请求；有分级限流；媒体必须先上传到平台；服务与功能可随时增删或停服；账号严重或反复违规会被封停；逾期未付存储费可能被暂停服务并在宽限期后删除内容。

身份与成熟度边界（必须说清）：ZOOOP 没有公开的代码仓库，因此没有 stars / forks 这类可交叉验证的社区指标，本文的身份依据只有官网域 zooop.ai、隐私政策与条款（两份都标注 2026-10-27 更新）以及页面自述。公开页面未披露运营主体的注册名称与注册地，条款也未给出适用法律与管辖地条款（本文只核到第 14 节「服务变更与终止」，未逐条核对全部条款）。MagicNetWorld 没有注册账号、没有付费、没有跑过任何一次生成任务，也没有测过任一模型的成片质量、成功率或耗时——上文所有功能与价格描述来自官方公开页面，属于文档级证据。

参考链接

• 官网与首页 FAQ（平台定义、模型清单、免费层、团队席位、商用授权）：https://zooop.ai/
• 定价页（套餐、积分数量、年付折扣、退款与存储计费）：https://zooop.ai/pricing
• API 文档（端点、参数、错误码、限流表、设备码流程）：https://zooop.ai/api-docs
• CLI 指南：https://zooop.ai/cli
• 服务条款（积分与计费、用户内容与知识产权、AI 生成内容、可接受使用）：https://zooop.ai/terms-of-service
• 隐私政策（收集范围、共享对象、注销与保留期限）：https://zooop.ai/privacy-policy
• 模板库：https://zooop.ai/templates
• 模型库：https://zooop.ai/models
• 一键工具页：https://zooop.ai/ai-tools