4AICode는 총 토큰(prompt + completion 합계) 기준으로 과금하며, 각 팀에는 월간 할당량이 있습니다.
단위: 토큰이란
토큰은 글자 수도 단어도 아닙니다. 대략적인 추정:
- 영어: 1 token ≈ 3–4 characters / 0.75 words
- 한국어·중국어: 한 글자 ≈ 1–2 tokens
- 코드: 영어와 중국어 사이 정도
예: 1,000자 한국어 문서 ≈ 1,500–2,000 input tokens; 500자 응답 ≈ 800–1,000 output tokens.
월간 할당량
- 개인 계정: 가입 시 무료 크레딧 제공
- 팀: 플랜에 따라 설정
진행률은 대시보드 → 사용량 보기에서 매분 갱신됩니다. 할당량은 매월 1일 00:00 UTC에 리셋됩니다.
초과 시
즉시 HTTP 429를 반환합니다.
{
"code": "quota_exceeded",
"message": "monthly quota reached, contact admin"
}
요청은 업스트림으로 전달되지 않으므로 과금되지 않습니다. 다음 달 1일에 자동으로 접근이 복구됩니다.
비용 관리
더 작은 모델 선택
claude-haiku-*는 sonnet / opus보다 한 자릿수 이상 저렴gpt-5.4-mini는gpt-5.4보다 저렴
요약, 분류, 번역 같은 단순 작업은 haiku / mini를 먼저 시도하세요.
max_tokens 조절
Anthropic /v1/messages는 max_tokens가 필수입니다. 실제 필요에 맞게 설정하고 기본 4096으로 두지 마세요.
{
"max_tokens": 512,
"messages": [...]
}
출력을 잘라 이어 받는 것이 한 번에 과도한 상한을 두는 것보다 항상 저렴합니다.
System prompt 중복 제거
긴 system 프롬프트(수천 단어)를 매번 보내면 비용이 큽니다.
- 안정적인 접두사는 Prompt Caching(Claude, GPT-6 Astra, GPT-5.6 지원)으로 재사용
- 변하지 않는 내용은 앞에, 변하는 내용은 뒤에 배치
GPT-6 Astra / GPT-5.6 캐시 및 장문 컨텍스트 요금
- 프롬프트 캐시 쓰기는 표준 입력 요율의 1.25×; 캐시 히트는 cache-read 요율로 과금.
- 단일 요청 입력 합계가 272,000 tokens를 넘으면 해당 요청 전체 입력 2×, 출력 1.5×.
- 사용 상세에 표준 입력, 캐시 쓰기, 캐시 읽기, 출력이 따로 기록되며, 최종 청구는 실제 사용량 기준.
스트리밍과 비스트리밍 비용 동일
stream: true는 과금에 영향을 주지 않습니다.
할당량 상향 요청
관리자 또는 support@4aicode.com에 문의하세요. 관리자는 30초 안에 갱신할 수 있습니다.
FAQ
Q: 토큰당 비용을 볼 수 있나요? A: 예. 사용량 페이지에서 토큰별로 필터할 수 있습니다.
Q: 언제 과금되나요? A: 응답이 완료될 때(또는 스트림이 끊길 때). 4xx / 5xx 응답은 과금되지 않습니다.
Q: 특정 토큰을 팀 할당량의 20%만 쓰게 할 수 있나요? A: 하위 할당량은 현재 지원하지 않습니다. 폐기 + 배포 통제로 한도를 맞추세요.