---
title: "Settle AI usage with the dedicated metering secret"
method: POST
path: "/v2/roster/ai/usage"
tags: ["Roster Builder"]
---

# Settle AI usage with the dedicated metering secret

`POST /v2/roster/ai/usage`

## Request

- Base URL: `https://api.clashk.ing`
- URL: `https://api.clashk.ing/v2/roster/ai/usage`
- Auth: API key in header `X-ClashKing-AI-Metering`

## Request body

- object
  - `requestId` string, required
  - `model` 'gpt-5.6-luna', required
  - `usage` object, required
    - `inputTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `cachedInputTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `cacheWriteTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `outputTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `reasoningTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
  - `steps` object[], required
    - `inputTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `cachedInputTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `cacheWriteTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `outputTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `reasoningTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'

## Response `204`

Success

## Other responses

- `400`: Expected error
- `401`: Expected error
- `403`: Expected error
- `404`: Expected error
- `409`: Expected error
- `413`: Expected error
- `429`: Expected error
- `503`: Expected error

## Changes

- **2026-09-09** `9ec0debedfc6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clashk/apis/clashking-api/changes/v2/roster/ai/usage/post.md)

---

[API](https://skmtc.dev/clashk/apis/clashking-api.md) - [All operations](https://skmtc.dev/clashk/apis/clashking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clashk/apis/clashking-api/revisions/8411b4ef8009?raw)