{"openapi":"3.0.3","info":{"title":"APICK 유튜브 자막 목록 조회","version":"1.0.0","description":"유튜브 공개 영상에서 제공하는 수동 자막과 자동 생성 자막의 언어 목록을 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/youtube_subtitle_list":{"post":{"summary":"유튜브 자막 목록 조회","description":"유튜브 공개 영상에서 제공하는 수동 자막과 자동 생성 자막의 언어 목록을 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"video_id":{"type":"string","description":"11자리 영상 ID"},"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 값으로 사용합니다."},"name":{"type":"string","description":"언어 이름. 없으면 null","nullable":true},"auto":{"type":"boolean","description":"자동 생성 여부 (subtitles 는 false)"},"formats":{"type":"array","items":{"type":"string"},"description":"원본 제공 형식 목록"}}},"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":"자동 번역 자막 여부. false 는 영상 원어의 음성 인식 자막입니다.자동 번역 자막은 유튜브 제한으로 내려받지 못할 수 있으니 원어 자막을 권장합니다."}}},"description":"자동 생성 자막 목록. 항목 구조는 subtitles 와 같고 auto 는 true 입니다."},"success":{"type":"integer","description":"과금 여부0: 실패1: 성공"}},"description":"조회 데이터"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"},"ms":{"type":"integer","description":"API 응답 시간"}},"description":"API 호출 공통 데이터"}}}}}},"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://youtu.be/dQw4w9WgXcQ"}},"required":["url"]}}}}}}},"x-code-tables":[{"title":"HTTP 상태 코드","columns":["HTTP","상황","설명"],"rows":[["400","입력 오류","유튜브 영상 주소 또는 영상 ID가 아닙니다."],["404","영상 없음","삭제·비공개 영상이거나 잘못된 주소입니다."],["424","조회 불가","연령 제한·회원 전용 영상이거나 일시적으로 조회하지 못했습니다. 실패한 호출은 과금하지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}