---
title: "Estimate Cost"
method: POST
path: "/cost/estimate"
tags: ["Cost Tracking"]
---

# Estimate Cost

`POST /cost/estimate`

Estimate cost for a given model and token counts.

This endpoint uses the same cost calculation logic as actual requests,
including any configured margins and discounts.

Parameters:
- model: Model name (e.g., "gpt-4", "claude-3-opus")
- input_tokens: Expected input tokens per request
- output_tokens: Expected output tokens per request
- num_requests_per_day: Number of requests per day (optional)
- num_requests_per_month: Number of requests per month (optional)

Returns cost breakdown including:
- Per-request costs (input, output, margin)
- Daily costs (if num_requests_per_day provided)
- Monthly costs (if num_requests_per_month provided)

Example:
```json
{
    "model": "gpt-4",
    "input_tokens": 1000,
    "output_tokens": 500,
    "num_requests_per_day": 100,
    "num_requests_per_month": 3000
}
```

## Request body

- CostEstimateRequest — Request body for /cost/estimate endpoint.
  - `model` string, required — Model name (from /model_group/info)
  - `input_tokens` integer, required — Expected input tokens per request
  - `output_tokens` integer, required — Expected output tokens per request
  - `num_requests_per_day` integer, nullable — Number of requests per day
  - `num_requests_per_month` integer, nullable — Number of requests per month

## Response `200`

Successful Response

- CostEstimateResponse — Response body for /cost/estimate endpoint.
  - `model` string, required
  - `input_tokens` integer, required
  - `output_tokens` integer, required
  - `num_requests_per_day` integer, nullable
  - `num_requests_per_month` integer, nullable
  - `cost_per_request` number, required — Total cost per request (includes margin)
  - `input_cost_per_request` number, required — Input token cost per request (before margin)
  - `output_cost_per_request` number, required — Output token cost per request (before margin)
  - `margin_cost_per_request` number — Margin/fee added per request
  - `daily_cost` number, nullable — Total daily cost (includes margin)
  - `daily_input_cost` number, nullable — Daily input token cost
  - `daily_output_cost` number, nullable — Daily output token cost
  - `daily_margin_cost` number, nullable — Daily margin/fee
  - `monthly_cost` number, nullable — Total monthly cost (includes margin)
  - `monthly_input_cost` number, nullable — Monthly input token cost
  - `monthly_output_cost` number, nullable — Monthly output token cost
  - `monthly_margin_cost` number, nullable — Monthly margin/fee
  - `input_cost_per_token` number, nullable
  - `output_cost_per_token` number, nullable
  - `provider` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/1e929292ddd5/schema)