· reAPI Team
OpenRouter 빈 응답에 요금 청구? 먼저 사용량 기록 확인
OpenRouter의 빈 응답에는 요금이 부과된 추론이나 클라이언트 오류가 숨겨져 있을 수 있습니다. 종료 이유, 사용량, Zero Completion Insurance 및 보조 요금을 확인하세요.

답변은 비어 있지만 usage.cost는 0이 아닙니다. 요금에 이의를 제기하거나 프롬프트를 다시 보내기 전에 해당 응답의 나머지 부분을 확인하세요. content 필드가 비어 있다는 사실만으로 모델이 토큰을 생성하지 않았는지, 추론에 예산을 썼는지, 인터페이스에 표시되지 않은 내용을 반환했는지는 알 수 없습니다.
이 차이는 OpenRouter에서 중요합니다. Zero Completion Insurance는 특정 실패 생성에 적용되지만, 추론은 눈에 보이는 답변이 없어도 요금이 부과될 수 있습니다. 두 경우 모두 빈 채팅 말풍선이 나타날 수 있습니다. 종료 이유와 사용량 기록을 보면 두 경우를 구분할 수 있습니다.[1][2]
누락된 답변이 토큰 수에 나타날 수 있습니다
다음은 Chat Completions 응답에서 발췌한 예시입니다. 숫자는 가상이며 요청은 실행되지 않았고, 이 설명과 관계없는 필드는 생략했습니다. 추론이 출력 한도를 소진하는 문서화된 패턴을 보여 줍니다.[2]
{
"choices": [
{
"message": { "content": "" },
"finish_reason": "length"
}
],
"usage": {
"completion_tokens": 1200,
"completion_tokens_details": {
"reasoning_tokens": 1200
}
}
}세 값을 함께 확인하세요. content에는 답변이 없습니다. length는 생성이 출력 한도에 도달했음을 나타냅니다. completion 수는 1,200이고, reasoning 세부 정보가 그 1,200 전부를 차지합니다. 따라서 이 예시의 표시된 출력 수는 1,200에서 1,200을 뺀 0입니다. 표시된 텍스트가 0이라고 모델 출력도 0인 것은 아닙니다.
대부분의 제공업체에서는 추론과 표시되는 출력이 요청의 출력 예산을 공유합니다. OpenRouter는 추론을 요금이 부과되는 출력으로 계산합니다.[2] 따라서 요청이 읽고 싶었던 부분에 도달하기 전에 한도를 모두 사용할 수 있습니다. 애플리케이션에는 만족스럽지 않은 결과지만, 보험 정책에 설명된 제로 completion 조건과는 다릅니다.
이 예시에서는 의도적으로 금액을 생략했습니다. 적용되는 모델과 요율이 없으면 토큰 수만으로 가격을 정할 수 없습니다. 이 가상 예시에 실제 모델의 요금을 임의로 적용하지 말고, 응답이나 해당 생성 기록에서 실제 usage.cost를 확인하세요.
추론을 숨겨도 해당 토큰은 절약되지 않습니다. Chat Completions에서 reasoning.exclude: true는 반환되는 추론을 억제하지만 작업과 요금은 그대로 유지합니다. Responses API는 이 제외 설정을 무시합니다.[2] 표시되는 답변이 없고 추론도 숨겨져 있으면, 사용량 기록에 작업 수행이 남아 있어도 인터페이스가 완전히 비어 있을 수 있습니다.
요청을 그대로 다시 보내기 전에 선택한 모델이 지원하는 추론 제어 설정을 검토하세요. 지원되는 낮은 추론 강도나 적절한 추론 예산은 답변을 위한 여유를 남길 수 있습니다. 전체 출력 한도를 늘리면 더 많은 작업이 허용되고 비용도 증가할 가능성이 있습니다. 작업에 맞는 변경을 선택한 뒤 다음 결과를 확인하세요. 어느 설정도 유용한 문장을 보장하지는 않습니다.
종료 이유가 다르면 요금 관련 질문도 달라집니다
이번에는 다른 기록을 살펴보겠습니다. completion 토큰은 0이고 종료 이유는 비어 있거나 null입니다. OpenRouter는 이 조합을 보호 대상이라고 명시합니다. error 종료 이유도 대상 조건으로 제시합니다. 적용 대상 요청의 prompt, completion, reasoning 토큰 요금은 0이며 보호가 자동으로 적용됩니다.[1]
이 조건을 그대로 유지하세요. “앱에 아무것도 표시되지 않았다”는 더 넓은 표현입니다. 정상적인 stop 이유, 도구 호출, 구조화된 결과 또는 클라이언트 파싱 실패라면 전체 페이로드를 확인해야 합니다. 어느 경우도 종료 이유가 비어 있고 토큰 수가 0인 것으로 조용히 다시 분류해서는 안 됩니다.
청구 내역에는 두 번째 구분도 있습니다. 보호 대상 생성이라도 검색, 파일 파싱, PDF OCR 또는 웹 가져오기처럼 이미 실행된 보조 작업에 요금이 부과될 수 있습니다. OpenRouter 정책은 이러한 서비스를 별도로 다루며 일부 실패 사례에서는 해당 요금도 면제된다고 설명합니다.[1] 도구 작업을 시도했다는 사실은 요금이 청구되었다는 증거가 아닙니다. 실제 내역을 확인하세요.
예를 들어 문서 요청에서 파싱은 완료되었지만 이후 모델 오류로 끝났다고 가정해 보세요. 모델 토큰 요금은 0이고 파싱 요금이 있는 기록은 보호 대상 모델 토큰에 요금이 있는 기록과 다른 질문을 제기합니다. 이는 정책이 적용되는 경계를 설명하는 것이며, 사용자의 문서 요청에 두 금액 중 어느 쪽이 청구되었다는 보고가 아닙니다.
지원팀에 문의하기 전에 이의를 제기할 항목을 확인하세요. 토큰 요금이 적용 조건을 충족하는 종료 이유와 충돌한다면 해당 필드를 함께 제공하세요. 파싱 요금이라면 기록에 어떤 파싱 작업이 표시되는지와 적용 규칙을 조사하세요. 총액 스크린샷만으로는 두 경우를 구분할 수 없습니다.
BYOK 사용량은 확인해야 할 계정을 하나 더 추가합니다. OpenRouter에 따르면 추론 제공업체가 BYOK 요청에 직접 요금을 청구합니다.[3] OpenRouter에 표시된 금액이 0이거나 조정되었다고 해서 외부 제공업체가 자체 요금을 취소했다는 사실이 입증되는 것은 아닙니다. 해당 요청을 대조할 때 제공업체 청구서와 OpenRouter 기록을 별도로 보관하세요.
실제로 호출한 API의 필드를 찾으세요
Chat Completions를 기반으로 만든 클라이언트는 읽는 필드 이름을 바꾸지 않고 Responses로 전환하면 사용량을 잃어버린 것처럼 보일 수 있습니다. OpenRouter 문서에는 동일한 과금 관련 질문에 서로 다른 필드 이름이 사용됩니다.[4]
| 필요한 항목 | Chat Completions | Responses |
|---|---|---|
| 입력 수 | usage.prompt_tokens | usage.input_tokens |
| 출력 수 | usage.completion_tokens | usage.output_tokens |
| 추론 수 | usage.completion_tokens_details.reasoning_tokens | usage.output_tokens_details.reasoning_tokens |
| 계정 요금 | usage.cost | usage.cost |
Responses에서 출력 예산 문제가 발생한 경우 status: "incomplete"와 incomplete_details.reason: "max_output_tokens"를 확인하세요. 응답에 추론은 있지만 출력에 메시지 항목은 없을 수 있습니다.[2] Chat Completions의 message.content 필드만 찾으면 실제로 받은 구조를 놓치게 됩니다.
값이 없으면 알 수 없는 상태로 유지하세요. 추론 세부 정보가 누락되었다면 0을 넣고 모든 출력 토큰이 표시되었다고 결론 내리지 마세요. 마찬가지로 직접 파싱한 객체에 usage.cost가 없다면 파서가 이를 버렸을 수 있습니다. 서비스가 해당 값을 생략했다고 판단하기 전에 원본 응답과 비교하세요.
유용한 비교 방법은 새 생성을 제출하지 않고 저장된 응답 하나를 동일한 표시 코드에 통과시키는 것입니다. 이 로컬 디버깅에서는 먼저 반환된 객체를 확인하고, 다음으로 파서가 선택한 값, 마지막으로 인터페이스에 전달된 값을 확인하세요. 첫 번째 객체에는 텍스트가 있는데 두 번째 객체에서 사라진다면 클라이언트 측 정보 손실 지점을 찾은 것입니다. 원본 기록에 위의 추론 예산 패턴만 있다면 표시 컴포넌트를 바꾸어도 생성되지 않은 답변을 제공할 수 없습니다. 표시를 수정해도 요금 관련 증거가 사라지지 않도록 원본 기록을 변경하지 마세요.
로컬에서 계산한 추정치는 보고된 요금과 별도로 유지하세요. 애플리케이션은 토큰 수와 저장된 가격표를 사용해 표시 값을 계산할 수 있습니다. 그 숫자는 유용할 수 있지만 요청에 보고된 요금과 서로 바꾸어 쓸 수 없습니다. 오래된 추정치로 반환된 0을 덮어써서는 안 되며, 추정치가 없다고 해서 무료 사용으로 기록해서도 안 됩니다.
현재 문서에 따르면 전체 사용량은 자동으로 반환됩니다. 이전 Chat Completions의 usage.include 및 stream_options.include_usage 스위치는 더 이상 사용되지 않으며 효과도 없습니다.[4] 이를 추가해도 클라이언트 파서를 수정하거나 도달하지 않은 이벤트를 복구할 수 없습니다.
기록이 도착하기 전에 스트림이 끝난 경우
스트림이 끊기면 다른 공백이 생깁니다. 애플리케이션이 최종 사용량 이벤트를 받지 못할 수 있습니다. OpenRouter에 따르면 스트리밍과 비스트리밍 요청에는 동일한 토큰 가격이 적용됩니다.[3] 스트리밍은 전달 방식을 바꿀 뿐 누락된 과금 데이터의 의미를 바꾸지 않습니다.
생성 ID가 도착하는 즉시 저장하세요. Responses 스트림에서는 종료 completed 또는 incomplete 이벤트에 사용량이 나타납니다. 해당 종료 이벤트가 없다면 클라이언트는 그 부재만으로 요금이 0이라고 추론할 수 없습니다.[4] 성공 또는 무료 완료를 만들어 내지 말고 실제로 받은 마지막 이벤트를 보존하세요.
HTTP 200만으로도 충분하지 않습니다. 응답 헤더가 전송된 뒤에도 응답 본문이나 스트림에 오류가 나타날 수 있습니다. OpenRouter는 이런 상황의 오류 종료 이유를 문서화합니다.[5] HTTP 로거에 저장된 상태만 보지 말고 이벤트 내용을 확인하세요.
저장된 ID를 사용해 생성 메타데이터를 조회하고 Activity와 비교하세요. 문서화된 조회에서는 종료 이유, 토큰 정보, 총비용과 생성 식별 정보를 제공합니다.[6] ID가 클라이언트에 전달되지 않았다면 지원팀에 문의할 수 있도록 타임스탬프, 요청 모델, 정제된 요청 컨텍스트를 보관하세요. 추적 기록에서 해당 레코드가 누락되었으며 비용은 아직 확인되지 않았습니다.
스트림을 거부하거나 잃어버리는 코딩 클라이언트의 경우 스트림 연결 해제 가이드에서 전달 문제를 별도로 다룹니다. 해당 클라이언트 동작을 조사하는 동안 과금 증거를 보존하세요.
전체 턴을 다시 실행하기 전에 이전 단계를 확인하세요
도구를 사용하는 대화에서는 첫 모델 호출이 성공하고 도구 작업이 완료된 뒤 최종 설명이 실패할 수 있습니다. 가상의 예로 파일은 성공적으로 업데이트되었지만 모델의 요약이 인터페이스에 도달하지 않은 경우를 생각해 보세요. 마지막 말풍선이 비어 있어도 파일 변경이 취소되거나 해당 턴의 모든 요청이 실패했다고 볼 수는 없습니다.
각 생성 ID를 자체 결과 및 요금과 연결하세요. 해당 도구를 요청한 모델 호출 옆에 도구 결과를 보관하세요. 워크플로를 다시 실행하기 전에 작업이 이미 수행되었는지 확인하세요. 전체 턴을 반복하면 새 작업이 발생하고 원래 과금 문제에 답하기가 더 어려워질 수 있습니다.
요청 내 제공업체 대체 처리와 애플리케이션이 새로 제출하는 요청도 구분하세요. OpenRouter의 가격 안내에 따르면 오류가 난 시도에는 모델 토큰 요금이 청구되지 않으며 완료된 보조 작업은 별도로 처리됩니다.[3] 새 클라이언트 요청에는 자체 기록이 필요하며 이전 시도의 보호는 그 결과를 설명하지 않습니다.
크레딧 구매 수수료는 이 비교에서 제외하세요. Standard 및 Business 계정은 크레딧을 수동 구매하거나 자동 충전으로 결제하며 요청 비용은 해당 잔액에서 차감됩니다. OpenRouter에 따르면 추론에는 서비스를 제공하는 제공업체의 정가가 적용되고 크레딧 구매에는 플랫폼 수수료가 부과됩니다.[3] 따라서 해당 경로가 작업량 비용을 절감하는지 판단하려면 모든 요청이 할인된다고 가정하지 말고 적용되는 모델 가격과 충전 수수료를 확인해야 합니다. OpenRouter 가격 가이드는 더 폭넓은 비교를 다룹니다. 카드 청구액은 한 번의 생성에 대한 모델 토큰 요금이 아닙니다. 이 사건에서 중요한 질문은 정확합니다. 어떤 생성, 종료 이유, 항목이 서로 맞지 않습니까? 기록이 일치하는데 답변이 나타나지 않았다면 기록이 가리키는 출력 예산, 응답 파서 또는 스트림 처리를 계속 조사하세요.
어떤 게이트웨이에서든 같은 점검을
출력 한도를 다 써 버리는 이 패턴은 특정 라우터에만 해당하지 않습니다. reAPI의 GPT-6 Sol은 추론 토큰을 출력 토큰으로 과금하며, max_completion_tokens는 추론과 보이는 텍스트를 합쳐서 제한합니다. 따라서 답변 길이만 고려해 정한 한도는 텍스트가 나오기 전에 소진될 수 있습니다. 스트리밍 응답에서는 usage가 [DONE] 직전의 마지막 데이터 청크에 담깁니다.[7]
제공업체를 비교할 때는 저장해 둔 같은 프롬프트를 같은 출력 한도로 보낸 뒤, 보이는 텍스트만 보지 말고 각 응답의 종료 이유와 사용량 필드를 확인하세요. 사용 가능한 모델과 현재 요금은 모델 카탈로그에 있습니다.
참고 자료
- OpenRouter, Zero Completion Insurance: 적용 조건, 토큰 보장 범위, 보조 서비스 예외. 2026년 11월 15일 검토.
- OpenRouter, Reasoning Tokens: 공유 출력 예산, 불완전한 응답, 추론 제외. 2026년 11월 15일 검토.
- OpenRouter, Pricing: 실패한 시도, 스트리밍, BYOK 청구 FAQ. 2026년 11월 15일 검토.
- OpenRouter, Usage Accounting: API별 필드, 자동 사용량, 생성 ID 조회. 2026년 11월 15일 검토.
- OpenRouter, Errors and Debugging: 응답 본문 및 스트리밍 오류 의미. 2026년 11월 15일 검토.
- OpenRouter, Get request and usage metadata for a generation. 2026년 11월 15일 검토. 전체 소스 URL과 공개 스냅샷은 연구 아카이브에 보관되어 있습니다.
- reAPI. GPT-6 Sol API 참조. 2026년 11월 17일 검토. GPT-6 Sol.