ElevenCreative스튜디오

팟캐스트 생성

팟캐스트 프로젝트를 생성하고 자동 변환합니다. 현재 LLM 비용은 ElevenLabs가 부담하지만, 오디오 생성 비용은 청구됩니다. 향후에는 LLM 및 오디오 생성 비용이 모두 청구됩니다.

헤더

xi-api-keystring선택 사항
safety-identifierstring or null선택 사항

검토에 사용됩니다. 이 기능을 사용하려면 워크스페이스가 허용 목록에 포함되어야 합니다.

요청

This endpoint expects an object.
model_idstring필수

이 스튜디오 프로젝트에 사용할 모델의 ID입니다. GET /v1/models를 호출하여 사용 가능한 모든 모델을 나열할 수 있습니다.

modeobject필수

생성할 팟캐스트 유형입니다. 두 음성 간 상호작용인 ‘conversation’ 또는 독백인 ‘bulletin’ 중 하나일 수 있습니다.

sourceobject or list of objects필수

팟캐스트의 원본 콘텐츠입니다.

quality_presetenum or null선택 사항

생성된 오디오의 출력 품질입니다. 다음 중 하나여야 합니다. ‘standard’ - 표준 출력 형식, 샘플링 레이트 44.1kHz에서 128kbps. ‘high’ - 고품질 출력 형식, 샘플링 레이트 44.1kHz에서 192kbps 및 ElevenLabs 측의 주요 개선 사항 적용. ‘ultra’ - 초고품질 출력 형식, 샘플링 레이트 44.1kHz에서 192kbps 및 ElevenLabs 측의 최고 수준 개선 사항 적용. ‘ultra_lossless’ - 완전 무손실 형식의 초고품질 출력 형식, 샘플링 레이트 44.1kHz에서 705.6kbps 및 ElevenLabs 측의 최고 수준 개선 사항 적용. 제공하지 않으면 가입한 요금제에서 사용할 수 있는 최고 품질 프리셋이 기본값으로 적용됩니다.

허용된 값:
duration_scaleenum선택 사항기본값 default

생성된 팟캐스트의 길이입니다. 다음 중 하나여야 합니다. short - 3분 미만의 팟캐스트를 생성합니다. default - 약 3~7분 길이의 팟캐스트를 생성합니다. long - 7분 초과의 팟캐스트를 생성합니다.

허용된 값:
languagestring or null선택 사항=2 characters

Studio 프로젝트의 선택적 언어입니다. 두 글자 언어 코드(ISO 639-1)입니다.

introstring or null선택 사항<=1500 characters

팟캐스트 시작 부분에 항상 추가되는 인트로 텍스트입니다.

outrostring or null선택 사항<=1500 characters

팟캐스트 끝에 항상 추가될 아웃트로 텍스트입니다.

instructions_promptstring or null선택 사항<=3000 characters

팟캐스트의 스타일과 톤을 조정하는 데 사용할 팟캐스트 생성용 추가 지침 프롬프트입니다.

highlightslist of strings or null선택 사항

핵심 요점이나 주제를 제공하는 Studio 프로젝트 콘텐츠의 간략한 요약 또는 주요 내용입니다. 10~70자여야 합니다.

callback_urlstring or null선택 사항

Studio 프로젝트가 변환될 때 서비스에서 호출할 URL입니다. 요청에는 변환 상태가 포함된 JSON 블롭이 포함됩니다. 메시지:

  1. 프로젝트가 성공적으로 변환된 경우: { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “success”, project_snapshot_id: “22m00Tcm4TlvDq8ikMAT”, error_details: None, } }

  2. 프로젝트 변환에 실패한 경우: { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “error”, project_snapshot_id: None, error_details: “Error details if conversion failed” } }

  3. 챕터가 성공적으로 변환된 경우: { type: “chapter_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, chapter_id: “22m00Tcm4TlvDq8ikMAT”, conversion_status: “success”, chapter_snapshot_id: “23m00Tcm4TlvDq8ikMAV”, error_details: None, } }

  4. 챕터 변환에 실패한 경우: { type: “chapter_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, chapter_id: “22m00Tcm4TlvDq8ikMAT”, conversion_status: “error”, chapter_snapshot_id: None, error_details: “Error details if conversion failed” } }

apply_text_normalizationenum or null선택 사항

이 매개변수는 ‘auto’, ‘on’, ‘apply_english’, ‘off’의 네 가지 모드로 텍스트 정규화를 제어합니다. ‘auto’로 설정하면 시스템이 텍스트 정규화 적용 여부를 자동으로 결정합니다. (예: 숫자를 글자로 표기) ‘on’에서는 텍스트 정규화가 항상 적용되고, ‘off’에서는 건너뜁니다. ‘apply_english’는 ‘on’과 같지만 텍스트가 영어라고 가정합니다.

허용된 값:

응답

성공 응답

projectobject

생성된 팟캐스트와 연결된 프로젝트입니다.

오류

422
Unprocessable Entity Error