▶API 목차

Votxt OpenAPI 문서

베타 Votxt OpenAPI는 현재 베타입니다. 운영 환경에 사용하기 전에 개발 환경에서 통합을 테스트하세요.

개요

Votxt OpenAPI로 오디오 및 비디오 전사를 앱과 자동화 워크플로에 통합할 수 있습니다.

파일을 업로드하거나 외부 파일 URL을 사용한 뒤 전사 작업을 만들고 상태를 확인합니다.

완료 후 전사문, 자막, 구조화 데이터를 여러 형식으로 내보낼 수 있습니다.

기본 URL

https://api.votxt.co

인증

요청 헤더에 API 키를 보내세요. API 접근에는 API가 포함된 활성 플랜이 필요합니다.

X-API-Key: your_api_key_here

계정 설정을 엽니다.
플랜에 API 접근 권한이 포함되어 있는지 확인합니다.
API 키를 만들고 안전하게 보관합니다.

파일 업로드

서명된 URL로 직접 업로드하거나 공개 외부 파일 URL을 제공할 수 있습니다.

POST /api/v1/files/upload-url
PUT upload_url
POST /api/v1/transcriptions

POST /api/v1/files/upload-url
Content-Type: application/json
X-API-Key: your_api_key

{
  "filename": "audio.mp3",
  "file_size": 1048576,
  "upload_expires_in": 3600,
  "download_expires_in": 1800
}

전사

엔드포인트	메서드	설명
/api/v1/transcriptions	POST	파일 업로드
/api/v1/transcriptions/youtube	POST	비디오 링크
/api/v1/transcriptions	GET	전사 작업
/api/v1/transcriptions/{id}	GET	전사 편집기
/api/v1/transcriptions/{id}/status	GET	상태

POST /api/v1/transcriptions
Content-Type: application/json
X-API-Key: your_api_key

{
  "file_key": "12345-abc123def456.mp3",
  "filename": "audio.mp3",
  "language_code": "en",
  "transcription_type": "transcript",
  "enable_speaker_diarization": false,
  "webhook_url": "https://your-app.com/webhook"
}

상태

상태	전사
queued	대기 중
preprocessing	전처리 중
processing	처리 중
completed	완료
failed	실패

내보내기

완료 후 전사문, 자막, 구조화 데이터를 여러 형식으로 내보낼 수 있습니다.

내보내기	형식
내보내기	TXT
내보내기	SRT
내보내기	VTT
내보내기	JSON
내보내기	MD
내보내기	CSV
내보내기	DOCX
내보내기	PDF

형식

오디오 형식: mp3, mpeg, mpga, m4a, wav, aac, ogg, opus, flac
비디오 형식: mp4, webm, mov
최대 파일 크기: 파일당 최대 5GB

언어

Votxt는 다양한 전사 언어를 지원합니다. 요청에 언어 코드를 전달하세요.

언어	코드	언어	코드	언어	코드
Afrikaans	af	Gujarati (ગુજરાતી)	gu	Polish (Polski)	pl
Arabic (العربية)	ar	Hebrew (עברית)	he	Portuguese (Português)	pt
Azerbaijani (Azərbaycan)	az	Hindi (हिन्दी)	hi	Romanian (Română)	ro
Belarusian (Беларуская)	be	Croatian (Hrvatski)	hr	Russian (Русский)	ru
Bulgarian (Български)	bg	Haitian Creole (Kreyòl ayisyen)	ht	Slovak (Slovenčina)	sk
Bengali (বাংলা)	bn	Hungarian (Magyar)	hu	Slovenian (Slovenščina)	sl
Bosnian (Bosanski)	bs	Indonesian (Bahasa Indonesia)	id	Albanian (Shqip)	sq
Catalan (Català)	ca	Italian (Italiano)	it	Serbian (Српски)	sr
Czech (Čeština)	cs	Japanese (日本語)	ja	Swedish (Svenska)	sv
Welsh (Cymraeg)	cy	Kazakh (Қазақ)	kk	Swahili (Kiswahili)	sw
Danish (Dansk)	da	Kannada (ಕನ್ನಡ)	kn	Tamil (தமிழ்)	ta
German (Deutsch)	de	Korean (한국어)	ko	Telugu (తెలుగు)	te
Greek (Ελληνικά)	el	Lithuanian (Lietuvių)	lt	Thai (ไทย)	th
English	en	Latvian (Latviešu)	lv	Tagalog (Tagalog/Filipino)	tl
Spanish (Español)	es	Macedonian (Македонски)	mk	Turkish (Türkçe)	tr
Estonian (Eesti)	et	Malayalam (മലയാളം)	ml	Ukrainian (Українська)	uk
Basque (Euskara)	eu	Marathi (मराठी)	mr	Urdu (اردو)	ur
Persian (فارسی)	fa	Malay (Bahasa Melayu)	ms	Vietnamese (Tiếng Việt)	vi
Finnish (Suomi)	fi	Dutch (Nederlands)	nl	Chinese (Cantonese) (粵語)	yue
French (Français)	fr	Norwegian (Norsk)	no	Chinese (Simplified) (中文简体)	zh
Galician (Galego)	gl	Punjabi (ਪੰਜਾਬੀ)	pa	Chinese (Taiwanese Mandarin) (國語)	zh_tw