v3.2에서 버전 2024-11-15로 코드 마이그레이션
Speech to text REST API는 빠른 전사, 일괄 처리 전사 및 사용자 지정 음성에 사용됩니다. 이 문서에서는 버전 3.2에서 버전 2024-11-15로 변경된 내용을 설명합니다.
Important
Speech to text REST API 버전은 2024-11-15 일반적으로 사용할 수 있는 최신 버전입니다.
- 음성 텍스트 변환 REST API 버전은
2024-05-15-preview발표 날짜에 사용 중지됩니다. - Speech to text REST API
v3.0,v3.1,v3.23.2-preview.1, 및3.2-preview.2는 2026년 4월 1일에 사용 중지됩니다.
업그레이드에 대한 자세한 내용은 Speech to text REST API v3.0에서 v3.1로, v3.1에서 v3.2로, v3.2에서 2024-11-15로 마이그레이션 가이드를 참조하세요.
기본 경로
사용자 지정 음성 API는 일반적인 Azure API 버전 관리 체계에 맞춰 경로 기반 버전 관리 체계에서 쿼리 매개 변수 기반 스키마로 전환되었습니다. 이렇게 하려면 사용된 기본 경로를 변경해야 합니다. 경로를 /speechtotext/v3.2 업데이트하고 /speechtotext 모든 요청에 API 버전을 ?api-version=2024-11-15 추가합니다.
데이터 세트
email 속성 및 연결된 전자 메일 알림 프로세스가 API에서 제거됩니다.
데이터 세트 응답의 속성 이름이 duration 다른 이름으로 바뀌었 duration durationMilliseconds 으며 이제는 ISO8601 형식이 지정된 문자열(P1D2H3M4S...) 대신 일반 번호가 되어 더 간단하게 처리할 수 있습니다.
쿼리 매개 변수 sasValidityInSeconds 는 파일을 가져오기 위해 sasLifetimeMinutes 이름이 바뀝니다. BYOS가 비활성화된 계정에만 사용이 허용됩니다. BYOS 사용 계정의 경우 SAS URL이 반환되지 않습니다.
project 생성 요청에서 속성이 제거됩니다.
모델
text 모델 만들기 요청에서 속성을 제거했습니다. 대안은 텍스트 콘텐츠가 있는 데이터 세트를 만들고 먼저 데이터 세트를 만든 다음 나중에 모델 생성에 사용되는 것입니다.
email 속성 및 연결된 전자 메일 알림 프로세스가 API에서 제거됩니다.
쿼리 매개 변수 sasValidityInSeconds 는 파일을 가져오기 위해 sasLifetimeMinutes 이름이 바뀝니다. BYOS(사용자 고유의 스토리지 가져오기)를 사용하지 않도록 설정한 계정에만 사용이 허용됩니다. BYOS 사용 계정의 경우 SAS URL이 반환되지 않습니다.
이제 작업에는 GET models/id/manifest 항상 0이 아닌 SAS 수명이 필요합니다. 해당 sasValidityInSeconds 속성의 이름이 .로 sasLifetimeMinutes바뀝니다.
project 생성 요청에서 속성이 제거됩니다.
평가
쿼리 매개 변수 sasValidityInSeconds 는 파일을 가져오기 위해 sasLifetimeMinutes 이름이 바뀝니다. BYOS가 비활성화된 계정에만 사용이 허용됩니다. BYOS 사용 계정의 경우 SAS URL이 반환되지 않습니다.
project 생성 요청에서 속성이 제거됩니다.
email 속성 및 연결된 전자 메일 알림 프로세스가 API에서 제거됩니다.
엔드포인트
엔드포인트 로그의 로그 파일을 검색하고 삭제하는 API가 제거됩니다. 사용자 지정 음성은 이제 BYOS(사용자 고유의 스토리지 가져오기)를 지원합니다. BYOS를 사용하도록 설정된 계정만 모델 엔드포인트에 대한 로깅을 사용하도록 설정할 수 있습니다. 이렇게 하면 프록시 API 대신 고객 스토리지의 로그 파일을 완전히 관리할 수 있습니다.
엔드포인트에서 만들기에 대한 timeToLive 지원이 제거되었습니다.
text 엔드포인트 만들기 요청에서 속성을 제거했습니다. 대안은 텍스트 콘텐츠가 있는 데이터 세트를 만들고 먼저 데이터 세트를 만든 다음 나중에 모델 생성에 사용되는 것입니다. 그런 다음 이 모델을 사용하여 엔드포인트를 만들 수 있습니다.
이제 엔드포인트 링크는 SDK에 사용되는 websocket 연결의 엔드포인트만 반환합니다.
project 생성 요청에서 속성이 제거됩니다.
email 속성 및 연결된 전자 메일 알림 프로세스가 API에서 제거됩니다.
전사
전사의 최상위 diarizationEnabled 속성을 제거했습니다. 다이어리화 구성이 .로 "diarization": {"maxSpeakers": 2,"enabled": true}간소화되었습니다. 속성은 maxSpeakers 선택 사항이며 기본값은 2입니다. 이 enabled 속성은 다이어리화에 필요합니다.
전사 만들기: timeToLive 서식이 timeToLiveHours 지정된 문자열을 ISO8601 단순 int(시간)로 변경하는 형식 변경을 포함하도록 이름이 바뀌었습니다.
전사 응답의 속성 이름이 duration 다른 이름으로 바뀌었 duration 으며 이제 처리를 간소화하기 위해 durationMilliseconds ISO8601 형식 문자열(P1D2H3M4S...) 대신 일반 번호가 됩니다. 기록 결과 파일에는 API와의 일관성을 위해 이 속성이 추가됩니다.
쿼리 매개 변수 sasValidityInSeconds 는 파일을 가져오기 위해 sasLifetimeMinutes 이름이 바뀝니다. BYOS가 비활성화된 계정에만 사용이 허용됩니다. BYOS 사용 계정의 경우 SAS URL이 반환되지 않습니다.
project 생성 요청에서 속성이 제거됩니다.
email 속성 및 연결된 전자 메일 알림 프로세스가 API에서 제거됩니다.
프로젝트
프로젝트 API가 제거됩니다.