> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

获取指定时间范围内，指定成员的 AI 使用数据。
## 所需权限 {#bffd8534}
`statistics`
## 请求方式 {#fe3b5d5d}
```HTTP
POST /openapi/v1/statistics/user-metrics
```

## 请求体 {#65b506a9}
<!-- @cols-width: 143,120,100,159,339 -->
| | | | | | \
|**参数** |**类型** |**是否必填** |**默认值** |**描述** |
|---|---|---|---|---|
| | | | | | \
|`start_date` |string |是 |\- |开始日期。格式：YYYY-MM-DD。 |
| | | | | | \
|`end_date` |string |是 |\- |结束日期。格式：YYYY-MM-DD。 |
| | | | | | \
|`timezone` |string |否 |`"Asia/Shanghai"` |时区。需使用 IANA 时区名称。 |
| | | | | | \
|`user_ids` |int64[] |是 |\- |成员的 ID，最多 100 个。 |
| | | | | | \
|`emails` |string[] |是 |\- |成员的邮箱，最多 100 个。 |

:::tip 提示
`user_ids` 和 `emails` 参数只需提供其中一个。
由于 `user_ids` 的优先级高于 `emails`，若同时传入两个参数，`emails` 会被忽略。
:::
## 响应参数 {#cd88df11}
响应数据按成员维度组织，返回每位指定成员各自的 AI 使用数据。
<!-- @cols-width: 244,180,434 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`user_id` |int64 |成员的 ID。 |
| | | | \
|`email` |string |成员的邮箱。 |
| | | | \
|`metrics` |object |时间范围内的整体汇总数据。 |
| | | | \
|`daily_trend` |array |按天拆分的趋势数据。 |

`metrics` 对象和 `daily_trend` 数组包含的参数如下：
<!-- @cols-width: 244,180,434 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`date` |string |日期。格式：YYYY-MM-DD。该参数为 `daily_trend` 部分独有。 |
| | | | \
|`ai_generation_rate` |float64 |AI 生成代码在总代码产出中的占比（%）。 |
| | | | \
|`ai_contribution_rate` |float64 |AI 代码贡献率（%），表示最终提交到仓库的代码中，有多少来自 AI。 |
| | | | \
|`ai_generated_code_lines` |int64 |在对话和自动补全中，AI 生成的代码总行数。 |
| | | | \
|`chat_code_gen_lines` |int64 |在对话中，AI 生成的总代码行数。 |
| | | | \
|`chat_code_accept_lines` |int64 |在对话中，AI 生成的代码被采纳的总行数。 |
| | | | \
|`cue_recommend_count` |int64 |CUE 提供代码建议的总次数。 |
| | | | \
|`cue_recommend_accepted` |int64 |CUE 提供的代码建议被采纳的总次数。 |
| | | | \
|`ai_commit_lines` |int64 |AI 生成的代码被提交到仓库的总行数。 |
| | | | \
|`non_ai_commit_lines` |int64 |非 AI 生成的代码被提交到仓库的总行数。 |
| | | | \
|`total_commit_lines` |int64 |提交到仓库的总代码行数。 |

## 请求示例 {#9a726557}
```JSON
{
  "start_date": "2026-01-01",
  "end_date": "2026-01-31",
  "user_ids": [123456],
  "emails": ["name@example.com"]
}
```

## 响应示例 {#7df3e269}
```JSON
{
  "code": 0,
  "message": "success",
  "request_id": "req_abc123xyz",
  "data": {
    "users": [
      {
        "user_id": 12314124,
        "email": "name@example.com",
        "metrics": {
          "ai_generation_rate": 35.5,
          "ai_contribution_rate": 22,
          "ai_generated_code_lines": 120000,
          "chat_code_gen_lines": 500,
          "chat_code_accept_lines": 350,
          "cue_recommend_count": 50000,
          "cue_recommend_accepted": 150,
          "ai_commit_lines": 10000,
          "non_ai_commit_lines": 10000,
          "total_commit_lines": 20000
        },
        "daily_trend": [
          {
            "date": "2026-01-15",
            "ai_generation_rate": 25.5,
            "ai_contribution_rate": 18,
            "ai_generated_code_lines": 5000,
            "chat_code_gen_lines": 130,
            "chat_code_accept_lines": 100,
            "cue_recommend_count": 60,
            "cue_recommend_accepted": 30,
            "ai_commit_lines": 1000,
            "non_ai_commit_lines": 1000,
            "total_commit_lines": 2000
          }
        ]
      }
    ]
  }
}
```