For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
오디오 네이티브가 활성화된 프로젝트를 생성하고, 선택적으로 변환을 시작한 뒤 프로젝트 ID와 삽입 가능한 HTML 스니펫을 반환합니다.
헤더
xi-api-keystring선택 사항
요청
This endpoint expects a multipart form containing an optional file.
namestring필수
프로젝트 이름입니다.
imagestring or null선택 사항Deprecated
(지원 중단됨) 플레이어에서 사용할 이미지 URL입니다. 제공하지 않으면 플레이어 설정에 지정된 기본 이미지를 사용합니다.
authorstring or null선택 사항
플레이어에서 사용되고 업로드된 문서의 시작 부분에 삽입되는 작성자입니다. 제공하지 않으면 Player 설정에 지정된 기본 작성자가 사용됩니다.
titlestring or null선택 사항
플레이어에서 사용되고 업로드된 아티클 상단에 삽입되는 제목입니다. 제공하지 않으면 Player 설정에 지정된 기본 제목이 사용됩니다.
smallboolean선택 사항기본값 falseDeprecated
(지원 중단됨) 작은 플레이어를 사용할지 여부입니다. 제공하지 않으면 플레이어 설정에 지정된 기본값을 사용합니다.
text_colorstring or null선택 사항
플레이어에 사용되는 텍스트 색상입니다. 제공하지 않으면 플레이어 설정에서 지정한 기본 텍스트 색상이 사용됩니다.
background_colorstring or null선택 사항
플레이어에 사용되는 배경색입니다. 제공하지 않으면 Player 설정에 지정된 기본 배경색이 사용됩니다.
sessionizationinteger선택 사항기본값 0Deprecated
(지원 중단됨) 페이지를 새로고침해도 세션을 유지할 시간을 분 단위로 지정합니다. 제공하지 않으면 플레이어 설정에 지정된 기본 세션 설정을 사용합니다.
voice_idstring or null선택 사항
콘텐츠에 음성을 입히는 데 사용할 음성 ID입니다. 제공하지 않으면 Player 설정에 지정된 기본 음성 ID가 사용됩니다.
model_idstring or null선택 사항
플레이어에서 사용하는 TTS 모델 ID입니다. 제공되지 않으면 플레이어 설정에 지정된 기본 모델 ID가 사용됩니다.
filefile선택 사항
기사 콘텐츠가 포함된 txt 또는 HTML 입력 파일입니다. HTML은 다음 형식이어야 합니다. ‘<html><body><div><p>콘텐츠</p><h3>추가 콘텐츠</h3><p>추가 콘텐츠</p></div></body></html>’
auto_convertboolean선택 사항기본값 false
프로젝트를 오디오로 자동 변환할지 여부입니다.
apply_text_normalizationenum or null선택 사항
이 매개변수는 'auto', 'on', 'apply_english', 'off'의 네 가지 모드로 텍스트 정규화를 제어합니다.
'auto'로 설정하면 시스템이 텍스트 정규화 적용 여부를 자동으로 결정합니다.
(예: 숫자를 글자로 표기) 'on'에서는 텍스트 정규화가 항상 적용되고,
'off'에서는 건너뜁니다. 'apply_english'는 'on'과 같지만 텍스트가 영어라고 가정합니다.
허용된 값:
pronunciation_dictionary_locatorslist of strings선택 사항
텍스트에 적용할 발음 사전의 발음 사전 로케이터(pronunciation_dictionary_id, version_id)를 JSON 문자열 목록으로 인코딩한 값입니다. 프로젝트 추가는 jsonBody가 아닌 formData를 통해 이루어질 수 있으므로 JSON으로 인코딩된 문자열 목록이 필요합니다. 여러 사전을 지정하려면 curl에서 여러 --form 줄을 사용하세요. 예: --form 'pronunciation_dictionary_locators="{\"pronunciation_dictionary_id\":\"Vmd4Zor6fplcA7WrINey\",\"version_id\":\"hRPaxjlTdR7wFMhV4w0b\"}"' --form 'pronunciation_dictionary_locators="{\"pronunciation_dictionary_id\":\"JzWtcGQMJ6bnlWwyMo7e\",\"version_id\":\"lbmwxiLu4q6txYxgdZqn\"}"'.
이 매개변수는 ‘auto’, ‘on’, ‘apply_english’, ‘off’의 네 가지 모드로 텍스트 정규화를 제어합니다.
‘auto’로 설정하면 시스템이 텍스트 정규화 적용 여부를 자동으로 결정합니다.
(예: 숫자를 글자로 표기) ‘on’에서는 텍스트 정규화가 항상 적용되고,
‘off’에서는 건너뜁니다. ‘apply_english’는 ‘on’과 같지만 텍스트가 영어라고 가정합니다.
텍스트에 적용할 발음 사전의 발음 사전 로케이터(pronunciation_dictionary_id, version_id)를 JSON 문자열 목록으로 인코딩한 값입니다. 프로젝트 추가는 jsonBody가 아닌 formData를 통해 이루어질 수 있으므로 JSON으로 인코딩된 문자열 목록이 필요합니다. 여러 사전을 지정하려면 curl에서 여러 —form 줄을 사용하세요. 예: —form ‘pronunciation_dictionary_locators=”{“pronunciation_dictionary_id”:“Vmd4Zor6fplcA7WrINey”,“version_id”:“hRPaxjlTdR7wFMhV4w0b”}”’ —form ‘pronunciation_dictionary_locators=”{“pronunciation_dictionary_id”:“JzWtcGQMJ6bnlWwyMo7e”,“version_id”:“lbmwxiLu4q6txYxgdZqn”}”’.
