クイックスタート

まだコードを書く準備ができていませんか？ Playground を試してください — ブラウザで任意のモデルを直接テストでき、APIキーは不要です。

1. アカウントを作成する

runbase.net で Google またはメールでサインアップしてください。クレジットカードは不要です — 新しいアカウントには、開始用の無料残高が付与されます。

2. APIキーを取得する

Settings → API Keys に移動して新しいキーを作成します。安全な場所にコピーしておいてください — sk- で始まり、再表示されません。

export RUNBASE_API_KEY="sk-your-key-here"

3. 実行を作成する

POST を、モデル ID と入力パラメータを含めて /api/v1/runs に送信します:

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": {
      "prompt": "A cozy bookshop interior with warm lighting, watercolor style",
      "aspect_ratio": "1:1"
    }
  }'

レスポンス:

{
  "id": "run_2abc...",
  "model": "google/nano-banana-2",
  "status": "pending",
  "costUsd": 40000
}

costUsd は micro-USD です（1 USD = 1,000,000）。40,000 のコストは $0.04 を意味します。

4. 結果をポーリングする

run ID を使ってステータスを確認します:

curl -s https://runbase.net/api/v1/runs/run_2abc... \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

status が "succeeded" のとき、output フィールドに結果が含まれます:

{
  "id": "run_2abc...",
  "status": "succeeded",
  "model": "google/nano-banana-2",
  "costUsd": 40000,
  "output": {
    "urls": [
      "https://runbase.net/files/generated/abc123.png"
    ]
  },
  "createdAt": "2026-06-01T12:00:00.000Z",
  "completedAt": "2026-06-01T12:00:04.200Z"
}

実行が失敗した場合、status は "failed" となり、コストは自動的に残高に返金されます。

5. 画像をダウンロードする

出力内の URL は、生成された画像または動画への直接リンクです。グローバル CDN から配信され、すぐに利用できます。

次は何をするか

Core Concepts — 実行ライフサイクル、非同期モデル、コストの仕組みを理解する
Authentication — 本番環境向けに IP ホワイトリストと支出上限を設定する
Models — 利用可能なすべてのモデルを確認し、Playground で試す
Billing — 残高をチャージして管理する