Skip to main content
PiAPI
Workspace
PiAPI

Resources

CLIAPI DocsBilling
Credits$—
Theme

PiAPI CLI

在终端中使用 94 个多模态 AI 模型

生成图像、视频、音频、3D 资源，以及与 LLM 对话——全部通过一条命令。适合开发者、AI 代理和自动化工作流。

了解更多API 文档

使用 npm 安装：

$ npm install -g piapi-cli
在 npm 查看API 文档 →

一个 CLI 支持所有 AI 模型

flux-devnano-banana-progpt-image-2qwen-imageseedream-5-litemidjourneyz-imageremove-bgupscalefaceswap

运行 piapi model list 浏览所有模型

$ piapi run flux-dev prompt="a corgi astronaut"

CLI 命令

$ piapi run flux-dev prompt="a corgi" aspect_ratio=16:9

生成图像

$ piapi run gpt-4o prompt="hello" --stream

流式聊天

$ piapi run sora2-pro prompt="waves" --async

生成视频（异步）

$ piapi run remove-bg image=@./photo.png --download

上传并下载

完整命令参考和参数 →

学习 PiAPI CLI 工作流

常见问题

什么是 PiAPI CLI？

PiAPI CLI 是用于从终端运行 PiAPI 模型的命令行界面。它可作为 AI CLI 工具，用于图像、视频、音频、3D 和聊天生成工作流。

如何进行身份验证？

运行 piapi auth login --api-key sk-xxxxx 并输入您的 PiAPI API key。您可以从 PiAPI 工作区获取 API key。在共享机器上，建议使用环境变量 PIAPI_API_KEY=sk-...。

我可以从终端生成 AI 图像吗？

可以。使用 piapi run flux-dev prompt="a corgi astronaut" 或其他图像模型，从终端命令生成 AI 图像。添加 --download 可将生成文件保存到本地。

如何上传本地文件？

在任何输入前加上 @ 前缀即可上传本地文件。例如：piapi run remove-bg image=@./photo.png。文件会在模型运行前自动上传。上传功能需要付费 PiAPI 计划。

可以与 Claude Code 或 Cursor 等 AI 代理一起使用吗？

可以！PiAPI CLI 专为 AI 代理集成设计。使用 npx skills add PiAPI-1/piapi-cli 添加技能。

PiAPI CLI 免费吗？

CLI 本身免费且开源（MIT 许可证）。使用模型需要 PiAPI 账户——新账户可获得免费额度试用。模型定价请查看 piapi.ai/pricing。

如何安装 PiAPI CLI？

使用 npm 全局安装：npm install -g piapi-cli。也可以使用 pnpm、yarn 或 bun。或者使用 npx piapi-cli@latest 无需安装直接运行。需要 Node.js 18+。

支持哪些模型？

PiAPI CLI 支持 94 个多模态 AI 模型：34 个图像模型（Flux、Seedream、Nano Banana）、40 个视频模型（Sora 2、Kling 3、Veo 3）、10 个音频模型（F5-TTS、MMAudio）、2 个 3D 模型（Trellis）和 8 个 LLM 模型（GPT-4o、Claude）。运行 piapi model list 查看所有可用模型。

我可以从终端生成 AI 视频吗？

可以。使用 Sora、Kling、Veo、Seedance、Hailuo 和 Luma 等视频模型，从终端工作流生成 AI 视频。视频任务通常使用 --async，之后再查询任务状态。

如何下载生成的文件？

在任何命令中添加 --download 即可自动保存生成的文件。使用 --out-dir ./output 指定自定义输出目录。支持 URL 输出和 base64 编码。

同步和异步模式有什么区别？

LLM 和 gpt-image-2 模型同步运行（结果立即返回）。视频和 3D 模型需要 --async 参数并返回任务 ID 用于轮询。使用 piapi task get <id> 检查状态。