88API88API
使用指南AI 应用API 文档帮助支持

一句话让 Agent 生图、做视频

把插件仓库地址和 88API Key 发给 Claude Code、Codex、ZCode、DeepSeek Harness、Trae 等 Agent,用一句话生成图片、短片和广告片。

适用范围

这两个插件适合平时就在 Agent 客户端里工作的用户:直接用中文描述需求,Agent 会选模型、调用 88API、把结果保存到本机。只想在网页上提交任务、集中管理结果,请使用生图工作台和视频工作台。

88API 提供两个开源插件,安装方式和使用习惯完全一致:

插件能做什么仓库地址
88API-Image-Gen(生图)调用 88API 全部生图模型:GPT Image、Nano Banana(Gemini)、Grok、Seedream、Midjourney。文生图、改图、多参考图、1K/2K/4K、透明背景、批量出图github.com/blackdm666/88API-image-gen
88API-Video-Studio(视频)调用 88API 全部视频模型。一句话出短片或广告片;把参考视频反推成提示词;整理成可复刻的工程包github.com/blackdm666/88API-Video-Studio

支持 Claude Code、Codex、ZCode、DeepSeek Harness、Trae,以及 Cursor、Cline、Gemini CLI 等能读 SKILL.md 技能的客户端。两个插件可以单独装,也可以一起装:先用生图插件做关键帧、人物或产品图,再交给视频插件生成视频。

傻瓜式安装:复制一段话给 AI

完全不懂命令也没关系。打开你的 Agent 客户端,新开一个对话,把下面这段话原样复制发给它:

请先阅读这篇文章:https://88api.ai/zh/docs/apps/image-video-plugins/
然后按文章里「给 AI 的安装说明」一节,
在我现在用的这个客户端里,帮我安装 88API 的生图插件和视频插件。
需要我自己点按钮、确认或新开对话的地方,请一步一步告诉我该怎么做。
装好以后,请告诉我下一步要做什么,并问我要 88API 的 Key。

接下来只要照 AI 说的做:

  1. AI 安装过程中如果弹出审批或确认,点同意;
  2. AI 让你新开对话(Codex 是新建任务)时,照做;
  3. AI 问你要 Key 时,按下方第 2 步创建并复制 Key 发给它;
  4. 然后直接说「画一张水彩小橘猫」或「做一条 10 秒竖屏运动鞋广告」试试。

只要其中一个插件,把这段话里的「生图插件和视频插件」改成你要的那个即可。如果 AI 说打不开网页,用下面第 1 步的仓库地址代替。

最快上手:把仓库地址和 Key 发给 AI

不想用上面那段话,也可以分三步自己来。

第 1 步:把仓库地址发给 AI

在你的 Agent 客户端里新开一个对话,把下面这句话发给它(只要视频就换成视频插件的地址,两个都要就一起发):

帮我安装这个插件:https://github.com/blackdm666/88API-image-gen
帮我安装这个插件:https://github.com/blackdm666/88API-Video-Studio

Agent 会按你用的客户端选择安装方式。装好后新开一个对话(Codex 新建任务),客户端才会加载插件。Agent 装不了时(例如需要你在设置页面里点按钮),按下方手动安装操作即可。

第 2 步:把 Key 发给 AI

  1. 登录 88API,进入「API 密钥」页面,点击「创建 API 密钥」。名称随意填写,分组选择 auto(自动分组)。一个 Key 就够,两个插件共用。
在 88API 的创建 API 密钥窗口填写名称,并把分组选为 auto 自动分组
  1. 在 API 密钥列表里点击复制按钮,复制完整的 Key。
在 88API 的 API 密钥列表中点击复制按钮,复制完整的 Key
  1. 新开对话后直接说需求,例如「画一张水彩小橘猫」。Agent 发现还没有 Key 时会主动向你要,把复制的 Key 发给它即可。它会保存到本机、做脱敏验证(只显示 sk-xxxx...xxxx 这样的预览),然后自动继续你刚才的需求,不用重新描述。

视频插件第一次出片时,还会要一个个人访问令牌:登录 88API 控制台,进入左侧「安全与访问」,在「访问令牌」中点击「创建访问令牌」,权限只勾选「查看」类即可,同样直接发给 Agent。它只用来查询余额、实时价格和模型可用状态,和 API Key 不是同一个东西。

第 3 步:一句话出图、出片

画一张 16:9 的雨夜城市海报,霓虹灯倒映在积水里。
做一条 10 秒竖屏运动鞋广告。

更多说法见下方生成图片和生成视频。

关于 Key 的安全

只在你信任的 Agent 对话里发 Key,不要贴到 GitHub Issue、公开群聊或截图里。Key 保存在本机的 ~/.88api/ 文件夹,两个插件、本机所有客户端共用:在一个插件里配过,另一个就不会再问。不想在聊天里发 Key,也可以在系统里设置环境变量 API88_KEY。

使用前准备

  • Node.js 18 或更高版本:插件在本机运行 Node.js 脚本。终端运行 node -v 能看到版本号即可。
  • ffmpeg:只有视频插件的「反推」和多段「拼接」需要,只做一句话出片可以先不装。
  • 沙箱客户端要批准一次:DeepSeek Harness 等客户端保存 Key 时会弹出审批,请点同意。不能审批的模式(例如无头运行)里无法保存,请换到普通对话里配置。

手动安装

Agent 没能自己装好时,按你的客户端在对应行操作。

生图插件 88API-Image-Gen

客户端安装方式
Claude Code在对话里输入 /plugin marketplace add blackdm666/88API-image-gen,再输入 /plugin install 88api-image-gen@88api-plugins
Codex终端运行 codex plugin marketplace add blackdm666/88API-image-gen,然后在插件列表里安装 88API-Image-Gen
ZCode设置 → Plugins → Create → Add marketplace,填入 blackdm666/88API-image-gen,然后安装 88API-Image-Gen
DeepSeek Harness打开「添加插件」,填入 github:blackdm666/88API-image-gen,点「安装」
Trae终端运行 npx skills add blackdm666/88API-image-gen -g -a trae -y

视频插件 88API-Video-Studio

客户端安装方式
Claude Code在对话里输入 /plugin marketplace add blackdm666/88API-Video-Studio,再输入 /plugin install seedance-studio@seedance-studio-plugins
Codex终端运行 codex plugin marketplace add blackdm666/88API-Video-Studio,然后在插件列表里安装 88API-Video-Studio
ZCode设置 → Plugins → Create → Add marketplace,填入 blackdm666/88API-Video-Studio,然后安装 88API-Video-Studio
DeepSeek Harness打开「添加插件」,填入 github:blackdm666/88API-Video-Studio,点「安装」
Trae终端运行 npx skills add blackdm666/88API-Video-Studio -g -a trae -y

DeepSeek Harness 装完要重启

在 DeepSeek Harness 里添加插件后,请完全退出并重新打开 DeepSeek Harness(托盘里的也要退出),再新开对话。否则插件列表里的名称可能还显示成包名。

其它客户端:复制技能文件夹

不在上表里的客户端,把插件仓库里的技能文件夹整个复制到客户端的技能目录,保持文件夹名不变,然后新开对话:

插件技能文件夹
生图plugins/88api-image-gen/skills/88api-image-gen/
视频plugins/seedance-studio/skills/seedance-studio/
客户端用户级技能目录
DeepSeek Harness(不用插件时)~/.dsh/skills/ 或 ~/.agents/skills/
Trae(不用命令时)~/.trae/skills/(Windows 为 %USERPROFILE%\.trae\skills\)
Cursor、Gemini CLI 等认公共目录的客户端~/.agents/skills/
Cline~/.cline/skills/
ZCode(不用插件时)~/.zcode/skills/

给 AI 的安装说明

这一节写给替用户安装插件的 AI Agent。用户已经让你阅读本文并安装插件时,按下面的步骤做:

  1. 确认客户端:判断你自己运行在哪个客户端里(Claude Code、Codex、ZCode、DeepSeek Harness、Trae 或其它)。拿不准时直接问用户。
  2. 确认要装哪个:用户没说时,两个都装:生图插件 blackdm666/88API-image-gen,视频插件 blackdm666/88API-Video-Studio。
  3. 按上方手动安装表格中对应客户端那一行安装:
    • Claude Code、Codex、Trae:可以自己在终端运行表格里的命令(Claude Code 用 claude plugin marketplace add <仓库> 和 claude plugin install <插件名>)。
    • ZCode、DeepSeek Harness:插件只能在设置页面里添加,请把表格里的操作和要填的地址一步一步告诉用户,等用户完成。
    • 其它客户端:把仓库里的技能文件夹复制到该客户端的用户级技能目录(见表格下方的「其它客户端」)。
    • 命令需要审批或写权限时,向用户说明原因并请求批准;不要绕过客户端的沙箱或权限设置。
  4. 告诉用户新开对话:安装后插件要在新对话(Codex 是新建任务)里才会加载;DeepSeek Harness 还要完全退出并重新打开。
  5. 配置 Key:新对话里由插件引导用户创建 auto 分组的 API Key 并发给你,用插件自带的命令保存并做脱敏验证。不要在回复里复述完整 Key,不要把 Key 写进项目文件或日志。视频插件出片前还需要个人访问令牌,同样由用户发给你保存。
  6. 不要替用户付费:安装和配置都不需要发起付费请求。用户第一次让你出图、出片时,按插件说明执行;视频要先让用户选模型并确认价格。

生成图片

直接用中文描述,想用哪个模型就点名:

画一张 16:9 的雨夜城市海报,霓虹灯倒映在积水里。
用 Nano Banana Pro 把这张截图里的文字改成英文,排版不变。
用 az-gpt-image-2 做一张透明背景的熊猫贴纸。
用我发的人物图和产品图,生成一张 4K 的产品展示图。
用 Grok 把这张照片改成水彩画风格。
用 Midjourney 出 4 张赛博朋克概念图。

选哪个模型

没点名时用默认的 gpt-image-2;点名模型或系列(如「用 Nano Banana」「用 Grok」)就用对应模型,只影响这一次。

系列模型适合分辨率计费
GPT Imagegpt-image-2(默认)、gpt-image-2.5-flare、gpt-image-2.5-sunburst通用出图和改图,精确像素尺寸1K / 2K / 4K按张
GPT Image 原生参数az-gpt-image-2、az-gpt-image-2.5-flare、az-gpt-image-2.5-sunburst透明背景、指定输出格式、更高质量档位、单次多张1K / 2K / 4K按 token
Gemini(Nano Banana)gemini-3.1-flash-image、gemini-nano-banana-2.1、gemini-3-pro-image文字渲染、人物一致性、按参考图精修1K / 2K / 4K按次
Grok Imaginegrok-imagine-image、grok-imagine-image-quality、grok-imagine-image-2.0、grok-imagine-edit出图快、比例多(15 种)1K / 2K按张
Seedreamdoubao-seedream-5-0-pro商业视觉、海报,支持最多 14 张公网参考图1K / 2K按张
Midjourneymidjourney-v8.2、midjourney-v8.2-fast、midjourney-v8.2-turbo艺术创作、概念设计,一次出 4 张—按次

具体价格以 模型定价页 为准。想知道你的 Key 能用哪些模型,问 Agent「列出可用的生图模型」即可,这一步不收费。各模型的参数范围见 GPT Image、Gemini、Grok 等生图接口文档。

说法小贴士

  • 比例、分辨率、质量、透明背景都可以直接说,例如「16:9」「4K」「高质量」「透明背景」。插件会换算成所选模型自己的参数写法;模型不支持的选项会在付费前拦下来,并告诉你可选的取值。
  • 改图时不说比例,会跟随第一张参考图的比例;想要别的比例就直接说「改成 16:9」。参考图可以是本机图片,也可以是公网图片链接。
  • 多张、多版本:「出 4 张」「同一个提示词重复生成 3 次」都可以,插件会在一次运行里调度完成。
  • 图片默认保存在 ~/Pictures/88api-image-gen,Agent 会告诉你实际路径,以及每张图用的模型和接口。

生成视频

视频插件有三种用法:

用法你说Agent 会做什么得到
想法 → 成片「做一条 10 秒竖屏运动鞋广告。」列出当前视频模型和实时价格 → 你选模型 → 按单段上限规划,必要时拆段再拼接单条短片 / TVC 的 MP4
视频 → 反推「反推这个视频的提示词:D:\videos\ref.mp4」抽帧逐帧分析画面、运镜、动作、文字、台词、BGM 和音效可以直接用来生成的提示词
视频 → 复刻工程包「把这个参考片做成可复刻工程包,我要换成自己的产品。」在反推基础上整理分镜、素材职责和缺失素材清单补齐素材即可一键生成的完整工程

第一次调用时,插件会先简单介绍这三种用法,然后继续你刚才的需求。

一句话出片

  1. Agent 列出 88API 当前所有视频模型的 ID、实时单价、能力和可用状态,由你选择模型(插件不会替你决定);
  2. 按所选模型的单段时长上限规划;超过上限时自动拆成几段、最后拼成一条,并先给你看拆段方案和总估算金额;
  3. 你确认后提交任务,告诉你任务 ID,然后持续监控进度,完成后把 MP4 下载到项目目录(默认 ./seedance-projects/<项目名>/)。每段的提示词也会存档在项目目录里,方便查看和复用。

视频一般需要几分钟。等待期间不要重复提交;就算对话中断,也可以让 Agent「继续查刚才的视频任务」,它会接着查同一个任务,不会重新扣费。

图生视频与人物、产品一致性

把产品图、人物图或关键帧发给 Agent,并说明它们分别负责什么,例如「图 1 锁定产品外形,图 2 作为开场构图」。插件会在付费前检查图片确实被带上,缺图时直接拦下,不会悄悄丢掉参考图出片。

  • 需要先做关键帧时,可以让视频插件直接出图,也可以用生图插件生成更多版本,再交给视频插件。
  • 你另外提供并明确说「用这个人」的人物照片,会作为唯一的人物身份参考,每张关键帧和视频都直接带上原图,避免越生成越不像。
  • 参考视频里的原演员不会被直接复用,插件会生成新的人物形象;原片的背景音乐也不会被提取。

能力边界

  • 时长、分辨率、画幅、参考素材和声音能力以所选模型的实时说明为准,不同模型差别很大。
  • 参考视频、参考音频需要公网可以直接下载的链接;本地图片由插件在提交前自动上传。
  • 「可用」表示模型目录、你的账户和当前 Key 三层检查都通过,不代表上游永远有容量,偶尔仍可能临时不可用。
  • 插件专注单条短片和 TVC,不做多集连续剧。想做系列,可以先做一条单集样片或预告,把风格和主角跑通。

各视频模型的参数和计费见视频接口文档。

费用与安全

  • 先看价格再付费:视频插件每次付费前都会展示所选模型、单价和估算金额;生图的计费单位见上方模型表,价格以 模型定价页 为准。
  • 付费前校验:比例、分辨率、质量、背景、参考图张数不符合模型能力时,直接报错,不发请求、不花钱。
  • 免费检查:查可用模型、查余额、查看配置、预演请求(dry-run)都不产生费用。
  • 绝不自动重发:请求一旦可能已被 88API 接收,插件就不会自动重试、换模型或换接口,避免重复扣费。你明确说「重试」时,Agent 才会再提交一次。
  • 中断后先查记录:命令被打断或超时,先让 Agent 查一下刚才的任务或提交记录,确认没出图、没出片再决定是否重试。图已生成但下载失败时,插件会保存结果链接,可以免费再下载一次(链接约 1 小时后失效)。
  • 你的 Key 所在分组不提供点名的模型时,88API 会直接提示哪些分组可以用,这类请求不扣费。

长任务与中断

一张图通常十几秒到一分钟,高质量、4K 或 Gemini Pro 可能要几分钟;一条视频一般要几分钟到十几分钟。有些客户端会更早结束命令(例如 Claude Code 默认 2 分钟),插件会让 Agent 把付费和等待命令放到后台运行。

命令被中断时,请求可能已经被接收并扣费。不要直接重发,先让 Agent 查一下状态。

Codex Auto 模式提示外网审批 429

Codex 的 Auto 模式会在插件访问网络前先做外网执行审批。如果报错里出现「外部网络执行授权」「沙箱网络权限」「审批服务」,或审批服务返回 429 Too Many Requests,那是 Codex 审批层的限流,不是 88API、Key 或模型的问题。被拦下的任务没有发到 88API,不会扣费。

想避免反复审批:

  1. Windows 按 Ctrl+, 打开 Codex 设置。
  2. 进入 General(通用)→ Permissions(权限),启用 Full access(完全访问)。
  3. 回到任务,在输入框下方的权限菜单里选择 Full access(完全访问)。
  4. 把剩下的图片合成一次批量请求重新提交。

Full access 会取消当前任务的本地沙箱和审批限制,请自行决定是否开启;插件不会自动改你的权限设置。选项灰掉时可能是组织策略限制,这时继续用一次批量请求,只审批一次即可。

升级插件

最简单的方式是对 Agent 说「帮我把 88API 的生图和视频插件升级到最新版」。也可以手动升级:

客户端生图插件视频插件
Claude Codeclaude plugin marketplace update 88api-plugins,再 claude plugin update 88api-image-gen@88api-pluginsclaude plugin marketplace update seedance-studio-plugins,再 claude plugin update seedance-studio@seedance-studio-plugins
Codexcodex plugin marketplace upgrade 88api-pluginscodex plugin marketplace upgrade seedance-studio-plugins
ZCode在插件设置里刷新市场并更新同左
DeepSeek Harness卸载后重新添加,再完全退出并重新打开同左
Traenpx skills update -g -y(两个插件一起更新)同左

升级后新开对话(Codex 新建任务)。想确认装的是哪个版本,问 Agent「插件现在是什么版本」即可。

常见问题

新开对话后 Agent 没有用插件

确认插件已启用,然后新开对话;也可以在需求里直接点名,例如「用 88API-Image-Gen 画……」「用 88API-Video-Studio 做……」。Trae 等客户端如果不自动调用技能,在需求里点名技能名即可:生图是 88api-image-gen,视频是 seedance-studio。

Agent 一直说没有配置 Key

让 Agent「查看插件配置」,看 Key 是否已保存、来自哪个文件。DeepSeek Harness 等沙箱客户端如果没有点审批,Key 不会保存成功,请重新发一次 Key 并在弹窗里同意。

点名的模型用不了

说明你的 Key 所在分组不提供这个模型。请求会照常发出,88API 会返回可用的分组,这类拒绝不扣费。在 88API 控制台的「API 密钥」页面把 Key 的分组改为 auto,或换一个包含该模型的分组。

88API 新上了模型,插件不认识

生图插件每天自动更新一次模型清单,也可以对 Agent 说「刷新生图模型清单」立即更新。视频插件每次出片前都会实时读取模型列表。

报错里出现「request was not sent」或「NO-AUTO-RETRY」

  • request was not sent:连不上 88API,请求没发出、没扣费,插件会自动重试。
  • NO-AUTO-RETRY 或请求超时:之前的请求可能已经扣费,插件不会自己重发。先让 Agent 查一下记录;确认没出图后,你明确说「重试」,Agent 才会再提交一次。

视频等了很久还没好

不同模型生成时间差别很大,几分钟到十几分钟都正常。插件会持续输出进度,不要重复提交;对话中断后让 Agent 继续查询原任务即可。

DeepSeek Harness 插件列表里名称显示成包名

完全退出 DeepSeek Harness(托盘也退出)再打开即可。