migoxlab LLM API 压测 (lmeterx-llm-loadtest)
对 LLM API 端点执行负载测试。支持 OpenAI 兼容 (/v1/chat/completions) 和 Claude 兼容 (/v1/messages) 接口。
路由规则
使用本 Skill：
- URL 以
/v1/chat/completions结尾（OpenAI 兼容） - URL 以
/v1/messages结尾（Claude/Anthropic 兼容） - 用户提到 "LLM"、"大模型"、"OpenAI"、"Claude"、"chat completions"
不要使用本 Skill：
| 场景 | 应使用 |
|---|---|
URL 是网页（如 https://www.baidu.com） |
/web-loadtest |
URL 是普通 API（如 /api/users、/graphql） |
/http-loadtest |
| 用户说 "网站/网页/页面" | /web-loadtest |
执行方式
必须通过 Bash 执行脚本，禁止手动构造 HTTP 请求。
获取用户提供的 LLM API URL 或 curl 命令后，在 Bash 中执行：
URL 模式：
export LMETERX_AUTH_TOKEN="${LMETERX_AUTH_TOKEN:-lmeterx}"
python ~/.claude/skills/lmeterx-llm-loadtest/scripts/run.py \
--url "<LLM API URL>" \
--header "Authorization: Bearer <api-key>" \
--body '{"model":"gpt-4","messages":[{"role":"user","content":"Hello"}]}'
curl 模式：
export LMETERX_AUTH_TOKEN="${LMETERX_AUTH_TOKEN:-lmeterx}"
python ~/.claude/skills/lmeterx-llm-loadtest/scripts/run.py \
--curl '<完整 curl 命令>'
自定义负载参数：
export LMETERX_AUTH_TOKEN="${LMETERX_AUTH_TOKEN:-lmeterx}"
python ~/.claude/skills/lmeterx-llm-loadtest/scripts/run.py \
--url "<LLM API URL>" \
--header "Authorization: Bearer <api-key>" \
--body '{"model":"gpt-4","messages":[{"role":"user","content":"Hi"}]}' \
--concurrent-users 50 \
--duration 300 \
--spawn-rate 30
参数说明
| 参数 | 默认值 | 说明 |
|---|---|---|
--url |
(必填，或用 --curl) | LLM API 端点 URL |
--curl |
(必填，或用 --url) | 完整 curl 命令字符串 |
--header |
[] | 请求头（可重复，格式 Key: Value） |
--body |
"" | 请求体 JSON 字符串 |
--model |
(自动从 body 提取) | 模型名称 |
--stream / --no-stream |
true | 流式模式 |
--concurrent-users |
50 | 并发用户数 (1-5000) |
--duration |
300 | 持续时间/秒 (1-172800) |
--spawn-rate |
30 | 用户生成速率 |
--name |
(自动生成) | 任务名称 |
--test-data |
"" | 数据集："" 不使用数据集，"default" 使用内置默认数据集 |
结果输出
执行完成后向用户报告：
- API 类型：OpenAI Chat 或 Claude Chat
- 预检结果：通过/失败及分类原因
- Task ID 及报告地址：
{LMETERX_BASE_URL}/results/{task_id}
环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
LMETERX_BASE_URL |
https://lmeterx.openxlab.org.cn |
LMeterX 后端地址 |
LMETERX_AUTH_TOKEN |
lmeterx |
Service Token（X-Authorization 头） |