rw-check-org-details

組織の詳細を確認する

前提条件： RUNWAYML_API_SECRET をサーバー側プロセスで利用できる必要があります。その値を決して表示したり貼り付けたりしないでください。

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

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

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

1. プロジェクトがサーバー側の環境から RUNWAYML_API_SECRET を読み込んでいるか確認します。
2. または、値を表示せずに現在のシェルを確認します：test -n "$RUNWAYML_API_SECRET"。

キーが見つからない場合は、Runway Developer Portal の設定でキーを作成し、サーバー側の環境に追加するようユーザーに依頼してから、処理を停止します。

ステップ 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 キーが無効または未設定	RUNWAYML_API_SECRET を有効な Developer Portal のキーに置き換えます
creditBalance が 0	クレジットを購入していない	https://dev.runwayml.com/ → Billing で購入します（最低 $10）
日次上限に到達	直近 24 時間の割り当てを使い切った	ウィンドウがリセットされるまで待つか、階層をアップグレードします
すべてのモデルで日次上限が 0 と表示される	階層 1 の制限	クレジットが購入済みであることを確認します