생성된 항목 가져오기

GET

/v1/history

GET

/v1/history

curl -G https://api.elevenlabs.io/v1/history \
     -d date_after_unix=1640995200 \
     -d date_before_unix=1640995200 \
     -d model_id=eleven_turbo_v2 \
     --data-urlencode "search=In the land far far away" \
     -d sort_direction=desc \
     -d source=TTS

{
  "history": [
    {
      "history_item_id": "ja9xsmfGhxYcymxGcOGB",
      "date_unix": 1714650306,
      "character_count_change_from": 17189,
      "character_count_change_to": 17231,
      "content_type": "audio/mpeg",
      "state": null,
      "request_id": "BF0BZg4IwLGBlaVjv9Im",
      "voice_id": "21m00Tcm4TlvDq8ikWAM",
      "model_id": "eleven_multilingual_v2",
      "voice_name": "Rachel",
      "voice_category": "premade",
      "text": "Hello, world!",
      "settings": {
        "similarity_boost": 0.5,
        "stability": 0.71,
        "style": 0,
        "use_speaker_boost": true
      },
      "source": "TTS"
    }
  ],
  "has_more": true,
  "last_history_item_id": "ja9xsmfGhxYcymxGcOGB",
  "scanned_until": 1714650306
}

생성한 오디오(예: 텍스트 음성 변환, 음성 변환, Studio, 더빙) 목록을 반환합니다. 음악 및 SFX 생성은 포함되지 않으며 현재 API를 통해 조회할 수 없습니다.

쿼리 매개변수

page_sizeinteger선택 사항기본값 100

반환할 최대 기록 항목 수입니다. 1000을 초과할 수 없으며 기본값은 100입니다.

start_after_history_item_idstring or null선택 사항

가져오기를 시작할 기준 ID입니다. 대량의 기록 항목을 페이지네이션하려면 이 매개변수를 사용하세요. 이 매개변수를 제공하지 않으면 생성일 기준 내림차순으로 가장 최근에 생성된 기록 항목부터 가져옵니다.

voice_idstring or null선택 사항

필터링할 음성의 ID입니다. 음성 가져오기 엔드포인트를 사용하여 사용 가능한 모든 음성을 나열할 수 있습니다.

model_idstring or null선택 사항

기록 항목을 필터링할 검색어입니다. 제공하면 source가 필수가 됩니다.

date_before_unixinteger or null선택 사항

이 날짜 이전의 기록 항목을 필터링하는 Unix 타임스탬프(제외)입니다.

date_after_unixinteger or null선택 사항

이 날짜 이후의 기록 항목을 필터링하는 Unix 타임스탬프(포함)입니다.

sort_directionenum or null선택 사항기본값 desc

결과 정렬 방향입니다.

허용된 값:

searchstring or null선택 사항

필터링에 사용할 검색어

sourceenum or null선택 사항

생성된 기록 항목의 출처

허용된 값:

응답

성공 응답

historylist of objects

음성 기록 항목 목록입니다.

has_moreboolean

가져올 기록 항목이 더 있는지 여부입니다.

last_history_item_idstring or null선택 사항

마지막 기록 항목의 ID입니다.

scanned_untilinteger or null선택 사항

마지막 기록 항목의 타임스탬프입니다.

오류

422

Unprocessable Entity Error

헤더

쿼리 매개변수

응답

오류