{"openapi":"3.0.3","info":{"title":"APICK 유튜브 자막 다운로드","version":"1.0.0","description":"유튜브 공개 영상의 자막을 언어별로 VTT·SRT·텍스트 파일로 내려받습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/youtube_subtitle":{"post":{"summary":"유튜브 자막 다운로드","description":"유튜브 공개 영상의 자막을 언어별로 VTT·SRT·텍스트 파일로 내려받습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"파일 직접 응답","content":{"text/vtt":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"유튜브 영상 URL 또는 11자리 영상 ID (string)","example":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"},"lang":{"type":"string","description":"자막 언어 코드 (예: ko, en, en-US, en-orig). 자막 목록 조회 결과의 lang 값. 자동 번역 자막(translated=true)은 실패할 수 있어 원어 자막을 권장 (string)","example":"ko"},"format":{"type":"string","description":"파일 형식 vtt(기본)·srt·txt. txt는 시간 정보를 뺀 본문만 반환합니다. (string)","example":"srt"},"type":{"type":"string","description":"자막 종류 any(기본: 수동 자막 우선, 없으면 자동 생성)·manual·auto (string)"}},"required":["url","lang"]}}}}}}},"x-code-tables":[{"title":"HTTP 상태 코드","columns":["HTTP","상황","설명"],"rows":[["400","입력 오류","영상 주소, lang, format, type 값을 확인하세요. 오류는 JSON으로 응답합니다."],["404","자막·영상 없음","요청한 언어의 자막이 없거나 삭제·비공개 영상입니다."],["424","조회 불가","연령 제한·회원 전용 영상이거나 일시적으로 가져오지 못했습니다. 자동 번역 자막은 이 오류가 잦습니다. 실패한 호출은 과금하지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}