Skip to main content
GET
/
v1
/
voice-usage
Retrieve TTS API usage data
curl --request GET \
  --url https://supertoneapi.com/v1/voice-usage \
  --header 'x-sup-api-key: <api-key>'
{
  "usages": [
    {
      "date": "<string>",
      "voice_id": "<string>",
      "total_minutes_used": 123,
      "name": "<string>",
      "style": "<string>",
      "language": "<string>",
      "model": "<string>",
      "thumbnail_url": "<string>"
    }
  ]
}
이 문서는 영어 원문을 기반으로 자동 번역되었습니다. 표현이 어색하거나 모호한 부분이 있을 수 있으니, 정확한 내용은 영어 원문을 함께 확인해 주세요.
요청한 기간 동안 (date, voice, style, language, model) 조합별로 생성된 오디오 분량을 반환합니다. 프리셋 보이스와 커스텀 보이스가 모두 응답에 포함됩니다. api_key 등의 커스텀 분해가 포함된 버킷 단위 분석은 Get usage를 사용해 주십시오.
날짜는 UTC+0 기준입니다. 최대 조회 기간은 30일입니다.

​
엔드포인트

GET https://supertoneapi.com/v1/voice-usage

​
쿼리 파라미터

NameRequiredDescription
start_date✅YYYY-MM-DD 형식의 시작 날짜입니다(UTC+0).
end_date✅YYYY-MM-DD 형식의 종료 날짜입니다(UTC+0).

​
요청 예시

GET /v1/voice-usage?start_date=2025-05-19&end_date=2025-05-28
x-sup-api-key: $SUPERTONE_API_KEY

​
응답 예시

{
  "usages": [
    {
      "date": "2025-05-22",
      "voice_id": "e5f6fb1a53d0add87afb4f",
      "name": "Agatha",
      "style": "neutral",
      "language": "en",
      "model": "sona_speech_1",
      "total_minutes_used": 12.43251349
    },
    {
      "date": "2025-05-24",
      "voice_id": "opSGuRvHBe7EfZ4LQga1hE",
      "name": "My Voice 1",
      "style": "sad",
      "language": "ko",
      "model": "sona_speech_1",
      "total_minutes_used": 3.24566213
    }
  ]
}

​
참고사항

  • 해당 기간에 사용 기록이 없으면 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