Loading...
Loading...
Query the Runway API for organization details: rate limits, credit balance, usage tier, and daily generation counts
npx skill4agent add runwayml/skills check-org-detailsPREREQUISITE: Runfirst to ensure the API key is configured.+setup-api-key
.envRUNWAYML_API_SECRETecho $RUNWAYML_API_SECRET+setup-api-keyGET /v1/organizationimport RunwayML from '@runwayml/sdk';
const client = new RunwayML();
const details = await client.organization.retrieve();
console.log(JSON.stringify(details, null, 2));from runwayml import RunwayML
client = RunwayML()
details = client.organization.retrieve()
print(details)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
}
}
}
}## 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.01POST /v1/organization/usageconst 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));usage = client.organization.retrieve_usage(
start_date="2026-02-15",
before_date="2026-03-17"
)
print(usage)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| Tier | Concurrency | Daily Gens | Monthly Cap | Unlock Requirement |
|---|---|---|---|---|
| 1 (default) | 1–2 | 50–200 | $100 | — |
| 2 | 3 | 500–1,000 | $500 | 1 day + $50 spent |
| 3 | 5 | 1,000–2,000 | $2,000 | 7 days + $100 spent |
| 4 | 10 | 5,000–10,000 | $20,000 | 14 days + $1,000 spent |
| 5 | 20 | 25,000–30,000 | $100,000 | 7 days + $5,000 spent |
| Issue | Cause | Fix |
|---|---|---|
| Invalid or missing API key | Re-run |
| No credits purchased | Purchase at https://dev.runwayml.com/ → Billing (min $10) |
| Daily limit reached | Rolling 24-hour quota exhausted | Wait for the window to reset, or upgrade tier |
| All models show 0 daily limit | Tier 1 restrictions | Check that credits have been purchased |