Claude 공식 릴리스 노트의 새 항목을 AI가 분석·정리한 글입니다. 정확한 내용은 하단 원문에서 확인해 주세요.
🤖 AI 분석 (Claude)
Messages API 응답에 usage.output_tokens_details.thinking_tokens 필드가 추가되었습니다. 이 필드는 청구되는 출력 토큰 중 확장 사고(extended thinking)에 사용된 토큰의 개수를 보고합니다.
스트리밍 사용 시에는 이 정보가 마지막 message_delta 이벤트에만 포함되며, 베타 헤더 없이도 즉시 이용할 수 있습니다.
왜 중요한가
이제 API 응답에서 확장 사고 기능이 실제로 얼마나 많은 토큰을 소비했는지 명확하게 추적할 수 있습니다. 이를 통해 비용 관리와 성능 최적화가 더 정확해집니다.
실제로 써보려면
Messages API를 호출한 후 응답의 usage.output_tokens_details.thinking_tokens 필드를 확인하면 됩니다. 스트리밍을 사용할 경우 마지막 message_delta 이벤트에서 이 정보를 볼 수 있습니다.
⚠️ AI가 원문을 바탕으로 생성한 분석입니다. 사실 확인은 아래 원문에서 해 주세요.
변경 내용 (원문)
The Messages API response now includes usage.output_tokens_details.thinking_tokens, reporting how many of the billed output tokens were extended thinking. When streaming, the breakdown appears only on the final message_delta event. No beta header is required.
출처: Claude Platform 릴리스 노트 (원문 보기)