check-org-details

查看组织详情

前提条件： 请先运行 +setup-api-key，确保已配置 API 密钥。

查询 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 的限制	确认已购买信用点