動画と
スクリプトとAIエージェントのための小さなコマンドです。ブラウザで確認するコードでログインし、すべてのジョブを実行前に見積もり、結果を待ってファイルを保存します。内部では公開APIを呼び出し、スタジオと同じくクリエイティブ残高を使います。
このツールはまだリリースされていません。以下のコマンドは使い方の紹介です。リリース後、インストール用のコマンドをここに掲載します。
ご自身のAIエージェントの接続はすべてのアカウントで使え、キーは要りません。コードで作業を自動化するための開発者APIキーは申請制です。
ログインは
各コマンドが見積もり、送信、待機、保存までをすべて行います。進行状況は標準エラーに出るので、スクリプトは結果だけを読めます。
- 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キー（申請制）を設定してください。保存されたログイン情報の代わりに使われます。
- すっきりした出力
- 結果は標準出力に、進行状況と問題は標準エラーに出ます。--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
いいえ。pershot login がリンクとコードを表示し、あなたがブラウザで許可すると、ツールは専用のログイン情報を受け取り、クリエイティブ残高を使います。PERSHOT_API_KEY に開発者APIキー（申請制）を設定することもでき、その場合は開発者API残高から支払われます。
ログイン
既定では ~/.config/pershot/credentials.json に保存され、あなたのユーザーだけが読めます。pershot logout はこのファイルを削除します。ログイン情報自体は、「AI接続」で取り消すか、90日後に期限が切れるまで残ります。
AI
pershot help --llms を一度実行させてください。すべてのコマンド、オプション、出力、終了コードが載っているので、エージェントが推測する必要はありません。
ツールに
いいえ。ログインして使うと、スタジオと同じ価格でクリエイティブ残高を使います。