Skip to main content
GET
Retrieve TTS API usage data
이 문서는 영어 원문을 기반으로 자동 번역되었습니다. 표현이 어색하거나 모호한 부분이 있을 수 있으니, 정확한 내용은 영어 원문을 함께 확인해 주세요.
요청한 기간 동안 (date, voice, style, language, model) 조합별로 생성된 오디오 분량을 반환합니다. 프리셋 보이스와 커스텀 보이스가 모두 응답에 포함됩니다. api_key 등의 커스텀 분해가 포함된 버킷 단위 분석은 Get usage를 사용해 주십시오.
날짜는 UTC+0 기준입니다. 최대 조회 기간은 30일입니다.

엔드포인트

쿼리 파라미터

요청 예시

응답 예시

참고사항

  • 해당 기간에 사용 기록이 없으면 usages는 빈 배열입니다.
  • total_minutes_used는 생성된 오디오의 실제 길이를 반영합니다(크레딧 차감에 사용되는 길이와 동일합니다).
  • 월간 예산 보고서 작성과 비용을 가장 많이 유발하는 캐릭터 식별에 유용합니다.

함께 보기

Docs: Cost and usage

운영 패턴: 주간 보고서, 이상치 알림, 사용량 귀속.

Get usage

다차원 분해가 가능한 버킷 단위 분석입니다.

Authorizations

x-sup-api-key
string
header
required

Query Parameters

start_date
string
required

The start date in YYYY-MM-DD format.

Example:

"2024-11-01"

end_date
string
required

The end date in YYYY-MM-DD format.

Example:

"2024-11-30"

Response

A list of TTS API usage records matching the specified date range.

usages
object[]
required