CLI

ターミナルで使う RunAPI CLI

1つのバイナリで画像生成、動画生成、AI音楽生成、LLM APIを呼び出せます。

macOS、Linux、amd64、arm64 に対応
クイックスタート
runapi
# インストール
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
runapi <service> <action> --input '{...}' JSON
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
runapi <service> <action> --input '{...}' JSON
機能

スクリプトとAIエージェント向け

JSON-first 出力

すべてのコマンドが、スクリプトやパイプラインで扱いやすい構造化 JSON を返します。

非同期タスク

時間のかかるモデルジョブを開始し、待機またはポーリングで結果を取得できます。

エージェントで使いやすい

コマンドはモデルの action と入力 schema に直接対応します。

FAQ

よくある質問

1つの RunAPI キーで始めましょう。

CLI をインストールして、最初の生成AIモデルを呼び出します。