---
title: "토큰 견적"
method: POST
path: "/api/v1/estimate"
---

# 토큰 견적

`POST /api/v1/estimate`

## Request

- Base URL: `https://aiwave.elopstudio.com`
- URL: `https://aiwave.elopstudio.com/api/v1/estimate`
- Auth: HTTP bearer

쓰는 만큼 얼마인지 모델별로 계산한다. 단가표(/api/v1/models)만으로도 곱셈은 할 수 있지만, 토큰 세기가 남는다 — 벤더마다 토크나이저가 다르고 한국어는 영어 기준 계산기와 크게 어긋난다. input/output 에 tokens 를 주면 그 값으로 곱하고, text 를 주면 o200k 기준으로 어림잡는다 (문단 길이에서 토큰 가중 오차 7.6%). 둘 다 주면 tokens 가 이긴다. 보낸 글은 저장하지 않는다 — 세고 버린다. 보내고 싶지 않으면 tokens 로 숫자만 주면 된다. models 를 비우면 싼 순으로 다섯 개를 고른다. 캐시·배치 할인과 구간 요금은 반영하지 않는다. 결과마다 costSplit 으로 비용이 입력·출력 중 어디서 나오는지 함께 준다 — 출력 비중이 크면 총액의 불확실성은 토큰 세기가 아니라 답 길이에 있다. 출력은 아직 쓰이지 않은 글이라 아무도 못 센다.

## Request body

- object
  - `input` object: 한 번 호출할 때 보내는 양
    - `tokens` integer
    - `text` string: 최대 200,000자
  - `output` object: 한 번 호출할 때 받는 양
    - `tokens` integer
    - `text` string
  - `calls` integer: 기간 내 호출 수
  - `models` string[]: 카탈로그 ID. 비우면 싼 순 5개

## Response `200`

모델별 견적. 싼 순으로 정렬한다.

## Other responses

- `400`: 본문이 잘못됨
- `401`: 인증 실패
- `429`: 하루 한도 초과
- `503`: 카탈로그를 불러오지 못함

---

[API](https://skmtc.dev/elopstudio/apis/ai-wave-api.md) · [All operations](https://skmtc.dev/elopstudio/apis/ai-wave-api/llms.txt) · [OpenAPI document](https://skmtc.dev/elopstudio/apis/ai-wave-api/revisions/5598fac87fef?raw)