Получить расходы по моделям
Возвращает посуточные (UTC) сегменты расходов на модели в пределах видимости использованного API-ключа. Без `group_by[]` возвращаются суточные итоги.
Authorization
BearerAuth Use an Atlas Cloud API key in the form Authorization: Bearer apikey-....
In: header
Query Parameters
Inclusive UTC start date in YYYY-MM-DD format.
dateExclusive UTC end date in YYYY-MM-DD format. The range can cover at most 180 daily buckets.
dateVisibility scope. self reads usage from the authenticated user's API keys. account requires account-level billing read permission.
"self"Value in
- "self"
- "account"
Repeated grouping parameter. Omit to return total daily buckets. Supported sets are model_type, model, api_key, and model plus api_key. Comma-delimited values are not accepted.
items <= 3Repeated model type filter. Omit to include text, image, and video.
items <= 3Repeated model ID filter. At most 100 IDs.
items <= 100Repeated API key public ID filter. Use ak_... IDs returned by API key management, not the secret apikey-... token.
items <= 100Maximum number of grouped rows to return.
1 <= value <= 1000100Opaque cursor from the previous response's next_page. Pass it back unchanged.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/public/v1/model-costs?start_date=2026-05-01&end_date=2026-05-08&group_by%5B%5D=model&group_by%5B%5D=api_key&model_types%5B%5D=text&model_types%5B%5D=image&model_ids%5B%5D=deepseek-v3&api_key_ids%5B%5D=ak_abc123"{ "object": "list", "scope": "account", "data": [ { "object": "model_cost.bucket", "date": "2026-05-01", "start_at": "2026-05-01T00:00:00Z", "end_at": "2026-05-02T00:00:00Z", "covered_until": "2026-05-02T00:00:00Z", "partial": false, "results": [ { "object": "model_cost.result", "amount": { "value": "0.240000", "currency": "usd" } } ] } ], "has_more": false, "next_page": null, "request_id": "req_123"}Last updated on