Setup
Before using any Runhuman integration, you need an account, an API key, and credits. This page walks you through all three.
1. Create an Account
Sign up at runhuman.com. You can register with GitHub or email — it takes under a minute.
Once signed in you land on the Dashboard, where you manage projects, API keys, and test results.
2. Get Your API Key
- Open the Dashboard
- Go to your organization’s API Keys page
- Click Create API Key and give it a name (e.g. “CI/CD” or “Development”)
- Copy the key immediately — it is only shown once
API keys are organization-scoped: one key works across every project in your organization.
Store the key as an environment variable or CI secret:
# Local development
export RUNHUMAN_API_KEY="qa_live_..."
# GitHub Actions — add as a repository secret named RUNHUMAN_API_KEY
# Settings > Secrets and variables > Actions > New repository secret3. Understand Billing
Runhuman charges per second of human tester time at $0.0085/sec (roughly $0.51/min).
| Duration | Approximate cost |
|---|---|
| 1 minute | $0.51 |
| 5 minutes | $2.55 |
| 10 minutes | $5.10 |
| 30 minutes | $15.30 |
Your organization’s credit balance is visible in the Dashboard. You can add credits from the Pricing page.
Next Steps
You’re ready to integrate. Pick the method that fits your workflow:
| Integration | Best for | Guide |
|---|---|---|
| AI Agents | Claude Code, Cursor, Windsurf, Copilot | Claude Code docs |
| REST API | Backend scripts, custom integrations | REST API docs |
| CLI | Terminal workflows, CI pipelines | CLI docs |
| GitHub Actions | Automated PR and scheduled testing | GitHub Actions docs |