금액 예약 및 차감

• 가격 — 입력·출력 1백만 토큰당 달러 가격입니다(또는 이미지, 영상 초, 문자 등 단위별 가격). 모델별 가격 확인: 카탈로그.
• 예약 금액 — 새 텍스트 요청을 보내기 전에 Ailoot는 합의된 요청 조건에 따라 입력과 일반적인 응답의 예상 비용을 예약합니다. 출력이 이미지, 영상, 오디오인 경우에는 결과 전체 비용의 예약을 유지합니다.
• 요청 거부 대신 한도 축소 — 계산한 예약액이 가용 잔액이나 키 한도를 초과하면, 실제로 한도를 지키는 해당 모델과 메서드에서만 응답 한도를 줄일 수 있습니다. 적용되는 최소값을 유지하면서 지불 가능한 범위까지만 줄입니다. 지원 모델은 다음에서 확인할 수 있습니다: 아래.
• 차감 — 다음 실제 사용량을 기준으로 한 번만 차감: usage. 남은 예약 금액은 즉시 반환됩니다.
• 응답 비용이 예약 금액을 초과할 때 — 다른 예약에 묶이지 않은 가용 잔액에서 차액을 차감합니다. 차감액은 잔액을 넘지 않으며 잔액은 음수가 되지 않습니다.
• 최소 예약 금액도 충당하지 못할 때 — 모델로 요청을 보내지 않고 이해하기 쉬운 402 오류를 반환합니다. 아무 금액도 차감하지 않습니다.
• 결과 없는 실패에는 과금하지 않음. 연결이 끊기면 다시 보내기 전에 대시보드 내역에서 Request ID로 요청을 확인하세요.

• 입력 — 요청 크기와 지원되는 첨부파일의 추정치를 기준으로 비용을 예약하며, 이미 확인된 실제 사용량을 기준으로 하지 않습니다. 새 텍스트 요청에서는 본문과 첨부파일의 유형에 따라 추정합니다. «바이트당 4토큰, 최소 4096토큰» 계산은 이전 버전에서 이미 합의된 예약액에 적용되며, 새 텍스트 예약액의 계산 방식을 설명하는 것이 아닙니다. 첨부파일을 링크로 전달하는 경우(fileData) 또는 내장 도구를 사용하는 경우, 지원되는 텍스트 요청에서는 첨부파일과 도구 작업을 각각 추정합니다. 이러한 요소가 있다는 이유만으로 전체 입력 윈도 비용을 예약하지는 않습니다. 이전 예약액에는 합의된 조건을 유지하고, 미디어 출력에는 결과 전체 비용을 계산합니다.
• 출력 — 새 텍스트 요청의 예약액을 계산할 때 일반적인 응답 길이와 합의된 조건을 기준으로 추정합니다. 요청한 한도는 다음 매개변수로 지정합니다: max_tokens (max_output_tokens 는 Responses에서 사용). 요청한 한도가 예약액 계산에 사용하는 토큰 수와 자동으로 같아지는 것은 아니며, 길이를 확실하게 제한할 수 없는 모델에서는 실제 응답 길이를 보장하지도 않습니다. 초기값 4096은 해당 경로에서만 적용되며, 구체적인 규칙은 모델과 메서드에 따라 달라집니다.
• 가격 — 새 텍스트 예약액을 계산할 때는 해당 요청의 조건에 따라 일반 또는 우선 처리 모드와 입력 추정치로 도달할 수 있는 가격 구간을 고려합니다. 선택한 조건 안에서는 보수적으로 계산하며, flex 모드로 예약액을 줄이지 않습니다. 우선 처리 요청에서는 priority, flex, fast를 포함해 적용 가능한 가장 비싼 모드를 예약액에 반영할 수 있습니다. 이러한 조건 없이 이전에 합의된 예약액에는 최고 요율을 적용한 원래 계산을 유지합니다.
• 한도 축소 — 계산한 예약액을 충당할 수 없고 해당 모델과 메서드에서 응답 길이를 제한할 수 있을 때 적용합니다. 가용 자금은 입력 추정치와 최소 출력량을 충당해야 합니다. 줄인 한도는 256토큰 미만이 되지 않습니다(Anthropic 형식에서 사고 기능을 사용하면 1025). 모델에는 이미 줄인 한도가 전달됩니다.

모델 claude-sonnet-5-5 — 입력 $2, 출력 $10 / 1백만 토큰. 입력 20 000토큰을 보내고 모델이 1 200토큰으로 응답한 경우입니다.

제시된 계산 예제의 실제 비용은 $0.0520입니다. 표시된 차감액은 합의된 예약액과 가용한 미예약 잔액으로 이 비용을 충당할 수 있다는 전제에 따른 값입니다. 이 예제에서는 예약액 자체를 계산하지 않습니다. 새 텍스트 요청의 예약액은 입력과 일반적인 응답의 추정치를 기준으로 별도로 정하며, 실제 비용보다 크거나 작을 수 있습니다. 사용하지 않은 예약액은 해제됩니다. 차감액의 상한은 아래 공식에 나와 있습니다.

실제 차감액 = min(전체 실제 비용, 수락한 보류 금액 + 보류되지 않은 가용 잔액). 다른 진행 중인 예약액은 보호되므로 전체 잔액이 반드시 영이 되는 것은 아닙니다. 잔액은 음수가 되지 않습니다. 실제 비용이 합의된 예약액과 미예약 가용 잔액의 합계를 초과하면, 충당하지 못한 차액은 Ailoot의 손실로 남습니다. 그 차액은 사용자의 채무가 되지 않으며 나중에 청구하거나 징수하지도 않습니다.

연결 종료, 앱 타임아웃 또는 이미 완성된 응답을 읽지 않는다고 요청이 자동 취소되지는 않습니다. 모델의 완성된 응답은 한 번만 결제됩니다. Ailoot의 책임으로 결과를 전달하지 못하면 금액을 반환합니다. 연결이 끊기면 재전송 전에 대시보드 내역에서 Request ID로 확인하세요.

• 새 텍스트 요청의 응답 예약액은 일반적인 응답 길이를 기준으로 계산하며, 지정한 max_tokens 의 값과 해당 모델의 조건을 반영합니다. 이는 예약액의 추정치이며, 실제 응답 길이나 비용을 보장하는 값이 아닙니다.
• 실제 응답 길이를 확실하게 제한할 수 없는 모델에서는 예약액의 추정치가 길이 제한으로 바뀌지 않습니다. 새 텍스트 요청에서 이 추정치를 가장 긴 응답의 비용으로 자동 대체하지도 않습니다. 이전에 합의된 예약액에는 원래 조건이 그대로 적용됩니다.
• 입력 이미지는 추정 비용을 예약액에 더합니다.
• 에이전트(Claude Code, Codex CLI, Cline)는 매 단계에서 큰 컨텍스트를 전송합니다. 한 단계에 수십 센트를 예약할 수 있으므로 최소 몇 달러의 잔액을 유지하세요.
• 팁: 적절한 한도를 지정하세요: max_tokens — 응답 길이를 제한할 수 있는 모델의 예약 금액을 줄입니다.

캐시 지원 모델은 캐시 쓰기와 읽기 가격이 다릅니다. 읽기는 보통 일반 입력보다 몇 배 저렴합니다. 가격은 카탈로그의 모델 카드에서 확인하세요.

가용 잔액이 최소 예약액도 충당하지 못하면 Ailoot는 요청을 보내지 않고 402 및 다음 코드를 반환합니다: insufficient_balance. 키 전체 지출 한도를 모두 쓰면 다음 코드: api_key_quota_exhausted. 계정에 이의 제기된 결제로 인한 채무가 있으면 다음 코드: payment_disputed: 채무를 상환할 때까지 새 요청이 중지됩니다.

{
  "error": {
    "code": "insufficient_balance",
    "reason": "insufficient_balance",
    "type": "insufficient_quota",
    "param": null,
    "message": "Your balance is too low to start this request. … Request ID: 5c0e7a1d-….",
    "request_id": "5c0e7a1d-…"
  }
}

요청·차감 내역이 있는 대시보드: ailoot.ai. 각 요청의 모델, 토큰, 금액을 볼 수 있습니다.