Skip to main content
프로젝트 생성

프로젝트 생성

비디오 또는 오디오 파일을 업로드하여 새 프로젝트를 생성합니다. API는 전사(번역이나 립싱크 없음)만 시작합니다. 나중에 VoiceCheap 앱에서 프로젝트를 열어 번역을 트리거하거나 프로젝트 세부 정보 가져오기을(를) 사용하여 프로젝트 상태를 검사할 수 있습니다.

동시성 제한

이 엔드포인트는 POST /v1/translate과(와) 동일한 동시성 제한을 공유합니다(계정당 최대 10개의 진행 중인 번역). 제한에 도달하면 요청은 CONCURRENT_TRANSLATION_LIMIT_REACHED(HTTP 429)을(를) 반환합니다.

요청

이 엔드포인트는 파일 업로드와 함께 multipart/form-data을(를) 허용합니다.

헤더

string
필수
귀하의 VoiceCheap API 키입니다. app.voicecheap.ai/page-api에서 키를 받으십시오.

본문 매개변수

file
필수
업로드할 비디오 또는 오디오 파일입니다.지원되는 비디오 형식: video/mp4, video/quicktime, video/x-matroska, video/webm, video/mpeg지원되는 오디오 형식: audio/mpeg, audio/wav, audio/mp4, audio/x-m4a, audio/flac, audio/ogg, audio/aac, audio/webm플랜별 최대 파일 크기: Beginner 5 GB, Starter 10 GB, Creator 20 GB, Pro 30 GB, Scale 40 GB 및 Enterprise 60 GB.
string
필수
이 프로젝트와 연결할 대상 언어입니다. 소문자여야 합니다.허용된 값(70개 이상): afrikaans, albanian, amharic, arabic, armenian, assamese, azerbaijani, basque, belarusian, bengali, bosnian, bulgarian, catalan, croatian, czech, danish, dutch, english, british english, estonian, finnish, french, french canadian, galician, german, greek, gujarati, hebrew, hindi, hungarian, icelandic, indonesian, irish, italian, japanese, kannada, kazakh, khmer, korean, lao, latvian, lithuanian, macedonian, malay, malayalam, mandarin, marathi, mongolian, nepali, norwegian, persian, polish, portuguese, brazilian portuguese, punjabi, romanian, russian, serbian, slovak, slovenian, spanish, swahili, swedish, tagalog, tamil, telugu, thai, turkish, ukrainian, urdu, vietnamese, welsh, yoruba, zulu
string
ISO 언어 코드를 사용하는 콘텐츠의 원본 언어입니다(예: en, es, fr, de, ja, zh).
강력 권장: 자동 감지를 위해 이 항목을 비워 두십시오.언어 코드가 정확하고 유효한 ISO 형식임을 100% 확신하는 경우에만 이 매개변수를 제공하십시오. 잘못된 언어 코드는 전사 실패를 유발합니다. 당사의 자동 감지는 80개 이상의 언어를 지원하며 매우 정확합니다.
기본값: auto-detect
string
프로젝트의 사용자 지정 이름입니다. 대시보드에서 프로젝트를 식별하는 데 유용합니다.기본값: 제공되지 않으면 프로젝트 ID가 사용됩니다.
string
이 프로젝트에 대한 웹훅 이벤트을(를) 수신하는 https 엔드포인트이며, 계정에 구성된 엔드포인트를 재정의합니다.기본값: 구성된 경우 계정 웹훅 엔드포인트.
string
auto-detect 또는 1에서 32 사이의 정수입니다. 알려진 화자 수를 제공하면 화자 분리(diarization)가 향상될 수 있습니다.기본값: auto-detect
string
요청별 이름, 브랜드, 약어 또는 전문 용어의 JSON 문자열 배열입니다. 이러한 용어는 저장된 계정 또는 팀 용어집과 병합됩니다.
boolean
전사 중에 일반적인 채움 단어를 제거합니다.기본값: true
string
기존 원본 언어 SRT 전사본입니다. 제공되는 경우 originalLanguage은(는) auto-detect이(가) 아닌 명시적인 언어 코드여야 합니다.
이 엔드포인트는 프로젝트 생성 + 전사 시작 전용입니다. 자막, 음성 복제, 음성 분리 및 배경 오디오와 같은 번역 옵션은 POST /v1/translate에서 처리합니다.

요청 예시

응답 예시

오류