check-org-details

組織の詳細を確認する

前提条件： API キーが設定されていることを確認するため、まず +setup-api-key を実行してください。

Runway API に問い合わせて、ユーザーの組織の詳細（クレジット残高、使用ティア、レート制限、現在の日次生成数、過去のクレジット使用状況）を取得します。

ステップ 1：API キーが利用可能か確認する

リクエストを送信する前に、API キーにアクセスできることを確認します。

1. RUNWAYML_API_SECRET を含む .env ファイルがあるか確認します
2. または、環境変数が設定されているか確認します：echo $RUNWAYML_API_SECRET

キーが見つからない場合は、まず +setup-api-key を実行するようユーザーに伝え、処理を停止します。

ステップ 2：組織情報を問い合わせる

GET /v1/organization を呼び出して、組織のティア、クレジット残高、現在の使用状況を取得します。

Node.js

import RunwayML from '@runwayml/sdk';

const client = new RunwayML();
const details = await client.organization.retrieve();
console.log(JSON.stringify(details, null, 2));

Python

from runwayml import RunwayML

client = RunwayML()
details = client.organization.retrieve()
print(details)

cURL / fetch（SDK なし）

curl -s https://api.dev.runwayml.com/v1/organization \
  -H "Authorization: Bearer $RUNWAYML_API_SECRET" \
  -H "X-Runway-Version: 2024-11-06" | python3 -m json.tool

レスポンス形式

{
  "tier": {
    "maxMonthlyCreditSpend": 10000,
    "models": {
      "gen4.5": {
        "maxConcurrentGenerations": 2,
        "maxDailyGenerations": 200
      }
    }
  },
  "creditBalance": 5000,
  "usage": {
    "models": {
      "gen4.5": {
        "dailyGenerations": 12
      }
    }
  }
}

ステップ 3：結果を提示する

ユーザー向けに、出力をわかりやすくまとめます。

## Organization Overview

**Credit Balance:** X credits ($X.XX at $0.01/credit)
**Monthly Spend Cap:** X credits

### Rate Limits (by model)

| Model | Concurrency | Daily Limit | Used Today | Remaining |
|-------|-------------|-------------|------------|-----------|
| gen4.5 | 2 | 200 | 12 | 188 |
| veo3.1 | 2 | 100 | 5 | 95 |
| ... | ... | ... | ... | ... |

特に次の点を強調します。

• クレジット残高 — ドル相当額に換算します（credits × $0.01）
• モデルごとの日次上限 — 今日残っている生成回数を示します（ローリング方式の 24 時間枠）
• 同時実行数 — モデルごとに同時実行できるタスク数を示します
• 月間上限 — ティアごとの月間クレジット使用上限を示します

ステップ 4（任意）：クレジット使用履歴を問い合わせる

ユーザーが過去の使用状況を確認したい場合は、POST /v1/organization/usage を呼び出します。

Node.js

const usage = await client.organization.retrieveUsage({
  startDate: '2026-02-15',   // ISO-8601, up to 90 days back
  beforeDate: '2026-03-17'   // exclusive end date
});
console.log(JSON.stringify(usage, null, 2));

Python

usage = client.organization.retrieve_usage(
    start_date="2026-02-15",
    before_date="2026-03-17"
)
print(usage)

cURL / fetch（SDK なし）

curl -s -X POST https://api.dev.runwayml.com/v1/organization/usage \
  -H "Authorization: Bearer $RUNWAYML_API_SECRET" \
  -H "X-Runway-Version: 2024-11-06" \
  -H "Content-Type: application/json" \
  -d '{"startDate": "2026-02-15", "beforeDate": "2026-03-17"}' \
  | python3 -m json.tool

レスポンス形式

{
  "results": [
    {
      "date": "2026-03-16",
      "usedCredits": [
        { "model": "gen4.5", "amount": 120 },
        { "model": "veo3.1", "amount": 400 }
      ]
    }
  ],
  "models": ["gen4.5", "veo3.1"]
}

使用状況の内訳として提示します。

### Credit Usage (Feb 15 – Mar 17)

| Date | Model | Credits Used |
|------|-------|-------------|
| 2026-03-16 | gen4.5 | 120 |
| 2026-03-16 | veo3.1 | 400 |
| ... | ... | ... |

**Total:** X credits

ティアの一覧

ユーザーがアップグレードについて尋ねた場合は、次のティアの内訳を共有します。

ティア	同時実行数	日次生成数	月間上限	利用条件
1（デフォルト）	1–2	50–200	$100	—
2	3	500–1,000	$500	1 日 + $50 の使用
3	5	1,000–2,000	$2,000	7 日 + $100 の使用
4	10	5,000–10,000	$20,000	14 日 + $1,000 の使用
5	20	25,000–30,000	$100,000	7 日 + $5,000 の使用

使用額と経過時間の条件を満たすと、ティアは自動的にアップグレードされます。

トラブルシューティング

問題	原因	解決方法
401 Unauthorized	API キーが無効、または設定されていません	+setup-api-key を再実行します
creditBalance が 0	クレジットが購入されていません	https://dev.runwayml.com/ → Billing で購入します（最低 $10）
日次上限に到達	ローリング方式の 24 時間枠の上限に達しました	枠がリセットされるまで待つか、ティアをアップグレードします
すべてのモデルで日次上限が 0 と表示される	ティア 1 の制限です	クレジットが購入済みか確認します