---
title: "Account task usage and current-key calls / 账号任务用量与当前密钥调用次数"
method: GET
path: "/usage"
---

# Account task usage and current-key calls / 账号任务用量与当前密钥调用次数

`GET /usage`

## Request

- Base URL: `https://clipmivoai.com/api/open/v1`
- URL: `https://clipmivoai.com/api/open/v1/usage`
- Auth: HTTP bearer

Account-wide retained, non-draft tasks selected by creation time, not per-key billing or settlement date. Deleted tasks are excluded. Current-key calls are lifetime counters including this call and permitted requests that later fail; invalid-key/scope failures are excluded. Non-atomic snapshot. / 按创建时间统计账号保留的非草稿任务，非按密钥账单或结算日期。排除已删除任务。当前密钥调用数为累计值，含本次及权限通过后失败的请求，不含无效密钥或权限失败。非原子快照。

## Query parameters

- `from` integer
- `to` integer

## Response `200`

Success / 成功

- object
  - `success` unknown, required
  - `request_id` string, required
  - `data` object, required
    - `as_of` integer, required
    - `period` object, required
      - `from` integer, required
      - `to` integer, required
      - `time_basis` 'task_created_at', required
      - `end_exclusive` unknown, required
    - `account_tasks` object, required
      - `scope` 'account', required
      - `excludes` string[], required
      - `count` integer, required
      - `by_status` object, required
      - `credits_settled` integer, required
    - `current_key` object, nullable, required
      - `id` string, required
      - `calls_total` integer, required
      - `last_used` integer, nullable, required

## Other responses

- `400`: Request rejected / 请求被拒绝
- `401`: Request rejected / 请求被拒绝
- `403`: Request rejected / 请求被拒绝
- `404`: Request rejected / 请求被拒绝
- `409`: Request rejected / 请求被拒绝
- `413`: Request rejected / 请求被拒绝
- `422`: Request rejected / 请求被拒绝
- `429`: Request rejected / 请求被拒绝
- `503`: Request rejected / 请求被拒绝

---

[API](https://skmtc.dev/clipmivoai/apis/clipmivoai-api.md) · [All operations](https://skmtc.dev/clipmivoai/apis/clipmivoai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clipmivoai/apis/clipmivoai-api/revisions/6e6d5f5a84a7?raw)