CLI
ターミナルで使う RunAPI CLI
1つのバイナリで画像生成、動画生成、AI音楽生成、LLM APIを呼び出せます。
macOS、Linux、amd64、arm64 に対応
# インストール
curl -fsSL https://runapi.ai/cli/install.sh | sh
# 認証
runapi login
# 画像を生成
runapi nano-banana generate \
--input '{"prompt":"a hummingbird drinking espresso"}'
# 音楽を生成して結果を取得
TASK_ID=$(runapi suno generate --async \
--input '{"prompt":"indie rock about coding"}' | jq -r .id)
runapi wait "$TASK_ID" --service suno --action generate
1つのバイナリで 130+ モデル。スクリプトやパイプライン向けの JSON-first 出力。
インストール
インストール方法を選択
Install with curl
macOS または Linux でインストーラーを実行します。
curl -fsSL https://runapi.ai/cli/install.sh | sh
Install with Homebrew
Homebrew が使える環境では RunAPI tap を利用します。
brew install runapi-ai/tap/runapi
Install with Go
公開 Go module から直接インストールします。
go install github.com/runapi-ai/cli/cmd/runapi@latest
クイックスタート
数分で構築を開始
認証して、動画生成、画像生成、AI音楽生成を実行します。
# ブラウザでログイン
runapi login
# CI / ヘッドレス環境では token を取り込み
printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -
# 確認
runapi auth status
runapi nano-banana generate \
--input '{"prompt":"a hummingbird drinking espresso","aspect_ratio":"1:1"}'
# { "id": "task_abc123", "status": "completed", "output": { ... } }
# 長時間ジョブを非同期で開始
TASK_ID=$(runapi suno generate --async \
--input '{"prompt":"upbeat indie rock about coding"}' | jq -r .id)
# 完了までポーリング
runapi wait "$TASK_ID" --service suno --action generate
機能
スクリプトとAIエージェント向け
JSON-first 出力
すべてのコマンドが、スクリプトやパイプラインで扱いやすい構造化 JSON を返します。
非同期タスク
時間のかかるモデルジョブを開始し、待機またはポーリングで結果を取得できます。
エージェントで使いやすい
コマンドはモデルの action と入力 schema に直接対応します。
FAQ
よくある質問
はい。API 利用分は RunAPI アカウントの従量課金で別途計算されます。
はい。RUNAPI_API_KEY を設定すれば、ターミナル、スクリプト、CI から利用できます。