视频和图片在命令行里生成
一个给脚本和 AI 智能体用的小命令。它用你在浏览器里确认的代码登录，每个任务执行前先报价，等结果出来再把文件存好。底层调用公开 API，和创作台一样花你的创作余额。
这个工具尚未发布。下面的命令展示它的用法；发布后，安装命令会放在这里。
连接你自己的 AI 智能体对所有账户开放，不需要 Key。开发者 API Key 按申请开通，供你用代码自动处理自己的业务。
登录一次之后一条命令拿一个结果
每条命令都把事情做完：报价、提交、等待、保存。进度写到标准错误，脚本只会读到结果。
- 01 · 登录
一个链接加一个代码，不用粘贴
pershot login 会打印一个链接和一个短代码。在任意浏览器里打开链接并登录，确认代码一致后点允许。工具随即拿到一个专门为它生成的登录凭据，存进只有你能读的文件里。在服务器或沙箱里也一样能用。
pershot login # Prints a link and a short code. Open the link in any browser, # check that the code matches and allow it. The key is saved for you. pershot whoami # which key and server are in use只需要已验证的邮箱。登录凭据会出现在“连接 AI”页面，你可以在那里设上限或撤销；它和创作台一样花你的创作余额。
- 02 · 视频
报价、提交、等待、保存
pershot video 后面用引号写提示词。它先询价并打印价格，再提交任务，一直跟到结束，把视频存进当前文件夹。标准输出上打印的是文件路径。
# Prints the price, submits, waits, then the path of the saved .mp4 pershot video "A paper boat on a rain puddle" -m mini -d 8 -r 480p -a 9:16 # The price only; nothing is submitted pershot video "A paper boat on a rain puddle" --dry-run # Refuse anything over 100 credits pershot video "A paper boat on a rain puddle" --max-credits 100不加参数时：Seedance 2.0 Fast、5 秒、720p、16:9、带音频。参数：-m fast 或 mini，-d 4 到 15 秒，-r 480p 或 720p，-a 16:9、9:16 或 1:1，-i 首帧图，--ref 最多 9 张参考图，--no-audio 不要音频。本地图片会先上传。
- 03 · 图片
图片也一样，还能改图
pershot image 的用法相同。用 -i 给它一张图，它就修改这张图，而不是新生成一张。
pershot image "A ceramic cup on a linen cloth, soft morning light" -s 2K # Edit a picture instead of making a new one pershot image "Make the background plain white" -i cup.png不加参数时：Fast、1K、1:1。参数：-m fast 或 mini，-s 1K 或 2K，-a 16:9、9:16 或 1:1。图片可以是 PNG、JPEG、WebP 文件，也可以是 https 链接。
- 04 · 给智能体
一份说明，读一次就够
pershot help --llms 会打印一份写给 AI 智能体的完整说明：每条命令和参数、每条命令返回的 JSON、每个退出码的含义。任何命令加上 --json，标准输出就只有一个 JSON 对象。
# The whole reference, written for agents: read it once pershot help --llms # One JSON object on standard output, no progress lines pershot video "A paper boat on a rain puddle" --json --quiet echo $? # the exit code: 0 done, 4 not enough credits, 9 stopped waiting加了 --json 后，错误也是 JSON，写在标准错误里，退出码说明是哪一类问题。
没人盯着也能放心跑
- 先报价
- 每个任务提交前都会先报价，并把价格打印出来。--dry-run 只打印价格，到此为止。
- 每条命令一个上限
- --max-credits 会拒绝任何更贵的任务，在上传或提交任何东西之前就拒绝。
- 重试不重复扣费
- 每个任务都带一个幂等键发出。用 --idempotency-key 指定你自己的键，再运行同一条命令时返回的是同一个任务，不会扣两次。
- 耗时长的任务
- --no-wait 打印任务 ID 后立即返回。工具停止等待时，任务照常进行，之后可以再接着等（见下方退出码 9）。
- 自己的登录凭据
- 保存的登录凭据只会发往它所属的服务器。想改用开发者 API 余额计费，把 PERSHOT_API_KEY 设为一把开发者 API Key（需申请开通），它会替代保存的登录凭据。
- 干净的输出
- 结果写到标准输出，进度和问题写到标准错误。--quiet 不打印进度行。
退出码含义始终不变
脚本和智能体可以根据退出码分别处理。每个退出码在工具的每个版本里含义都相同。
| 退出码 | 含义 | 怎么办 |
|---|---|---|
0 | 完成 | 从标准输出读取结果 |
1 | 意外错误 | 查看标准错误里的信息 |
2 | 命令写错了 | 改正命令。所有参数都在帮助里： pershot help |
3 | 未登录，或登录凭据、密钥被拒绝 | 登录： pershot login |
4 | 积分不足 | 充值后再运行一次 |
5 | 这把密钥无权这样做：权限、模型或地区不允许 | 换一把有权限的密钥 |
6 | 被拒绝：请求无效、超过 --max-credits、价格已变，或内容不被允许 | 修改请求 |
7 | 繁忙：触发了频率限制或并发限制 | 稍等后再试 |
8 | 任务失败或已取消 | 查看原因。如果产生了费用，任务里会写明： pershot job <id> |
9 | 停止等待，任务仍在继续 | 接着等： pershot job <id> --wait |
10 | 连不上服务，或服务器返回了错误 | 稍后用同一个 --idempotency-key 重试 |
11 | 等人批准。小样先做，其余的要等有人在网页上批准 | 请对方打开打印出的链接审阅，然后接着等这个批次： pershot batch wait <id> |
命令行常见问题
什么时候能安装？
还不能：这个工具尚未发布，真实生成也还没开放。在模型页留下邮箱，开放时我们写信通知你。
需要把 API Key 粘贴进去吗？
不需要。pershot login 会显示一个链接和一个代码，你在浏览器里允许后，工具就拿到自己的登录凭据，花的是你的创作余额。把开发者 API Key（需申请开通）放进 PERSHOT_API_KEY 也可以，那样扣的是开发者 API 余额。
登录凭据存在哪里？
默认存在 ~/.config/pershot/credentials.json，只有你的用户能读。pershot logout 会删除这个文件，但登录凭据本身仍列在“连接 AI”页面里，直到你在那里撤销，或 90 天后到期。
AI 智能体怎么学会用它？
让它运行一次 pershot help --llms。这份说明涵盖每条命令、参数、输出和退出码，智能体不用去猜。
这个工具要额外收费吗？
不要。登录后花的是你的创作余额，价格和创作台相同。