{"openapi":"3.0.3","info":{"title":"APICK 유튜브 자막 목록 조회","version":"1.0.0","description":"공개 영상에서 받을 수 있는 자막 언어를 수동 자막과 자동 생성 자막으로 나눠 알려 줍니다. 자막 본문은 오지 않으며, 응답의 lang 값을 유튜브 자막 다운로드의 lang에 그대로 넣습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/youtube_subtitle_list":{"post":{"summary":"유튜브 자막 목록 조회","description":"공개 영상에서 받을 수 있는 자막 언어를 수동 자막과 자동 생성 자막으로 나눠 알려 줍니다. 자막 본문은 오지 않으며, 응답의 lang 값을 유튜브 자막 다운로드의 lang에 그대로 넣습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"video_id":{"type":"string","description":"영상 ID(11자리)입니다."},"title":{"type":"string","description":"영상 제목입니다."},"original_language":{"type":"string","description":"영상 원어 코드입니다. 확인할 수 없으면 null입니다.","nullable":true},"subtitle_count":{"type":"integer","description":"수동 자막 언어 수입니다."},"automatic_caption_count":{"type":"integer","description":"자동 생성 자막 언어 수입니다."},"subtitles":{"type":"array","items":{"type":"object","properties":{"lang":{"type":"string","description":"언어 코드입니다. 자막 다운로드의 lang에 그대로 넣습니다. 예: en, ko, en-US"},"name":{"type":"string","description":"언어 이름입니다. 없으면 null입니다.","nullable":true},"auto":{"type":"boolean","description":"수동 자막은 항상 false입니다."},"formats":{"type":"array","items":{"type":"string"},"description":"원본에서 제공하는 자막 형식 이름 목록입니다. 다운로드 형식은 자막 다운로드의 format으로 고릅니다."}}},"description":"업로더가 올린 수동 자막 목록입니다. 언어 코드순입니다."},"automatic_captions":{"type":"array","items":{"type":"object","properties":{"lang":{"type":"string"},"name":{"type":"string"},"auto":{"type":"boolean"},"formats":{"type":"array","items":{"type":"string"}},"translated":{"type":"boolean","description":"자동 번역 자막이면 true, 영상 원어의 음성 인식 자막이면 false입니다. -orig로 끝나는 lang(예: en-orig)과 같은 언어의 lang(예: en)이 원어 자막입니다. 원어를 확인할 수 없는 영상은 모두 false로 옵니다."}}},"description":"자동 생성 자막 목록입니다. 항목 형식은 subtitles[]와 같고 auto가 true이며 translated가 더 붙습니다."},"success":{"type":"integer","description":"성공이면 1입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."},"pl_id":{"type":"integer","description":"결제 기록 번호입니다. 성공한 응답에만 옵니다."}}}}}}}},"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입니다. 예: https://youtu.be/dQw4w9WgXcQ 또는 dQw4w9WgXcQ. 재생목록·채널 URL은 영상 조회에 쓸 수 없습니다. (string)","example":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}},"required":["url"]}}}}}}},"x-code-tables":[{"title":"오류와 복구","columns":["상황","HTTP","data.error","해결"],"rows":[["입력 오류","400","입력 항목이 잘못됐습니다. 유튜브 영상 주소 또는 11자리 영상 ID를 입력해 주세요.","영상 주소 형식이나 11자리 ID를 확인합니다."],["영상 없음","404","영상을 찾을 수 없습니다. 삭제·비공개 영상이거나 잘못된 주소입니다.","주소와 공개 여부를 확인합니다."],["연령 제한","403","연령 제한 영상은 조회할 수 없습니다.","연령 제한 영상은 제공하지 않습니다."],["회원 전용","403","채널 회원 전용 영상은 조회할 수 없습니다.","채널 회원 전용 영상은 제공하지 않습니다."],["시간 초과","408","처리 시간 초과로 실패했습니다. 잠시 후 다시 시도해 주세요.","잠시 후 같은 요청을 다시 보냅니다."],["일시적 조회 실패","424","일시적으로 영상 정보를 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.","잠시 후 같은 요청을 다시 보냅니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}