rw-check-org-details

查看组织详情

前提条件：RUNWAYML_API_SECRET 必须对服务端进程可用。切勿打印或粘贴其值。

查询 Runway API，以获取用户的组织详情，包括积分余额、使用层级、速率限制、当前每日生成次数和历史积分使用情况。

第 1 步：确认 API 密钥可用

发出任何请求前，请确认 API 密钥可访问：

1. 检查项目是否从服务端环境加载 RUNWAYML_API_SECRET。
2. 或检查当前 shell，但不要打印其值：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 的限制	检查是否已购买积分