{"openapi":"3.0.3","info":{"title":"APICK 음성 변조","version":"1.0.0","description":"동영상 또는 오디오 파일 한 개를 올리면 목소리를 저음 또는 고음으로 바꾼 파일을 돌려줍니다. 응답은 JSON이 아닌 파일입니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/voice_change":{"post":{"summary":"음성 변조","description":"동영상 또는 오디오 파일 한 개를 올리면 목소리를 저음 또는 고음으로 바꾼 파일을 돌려줍니다. 응답은 JSON이 아닌 파일입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"파일 직접 응답","content":{"*/*":{"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":{"media":{"type":"string","description":"분석할 동영상 또는 오디오 파일입니다. 동영상이면 오디오 트랙만 사용합니다. (file)","format":"binary"},"type":{"type":"string","description":"변조음 타입 (1: 저음, 2: 고음) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"1"}},"required":["media","type"]}}}}}}},"x-code-tables":[{"title":"오류와 대처","columns":["HTTP","data.error","대처"],"rows":[["400","입력 항목이 잘못됐습니다.","type을 1 또는 2로 보내세요."],["400","파일 유형이 맞지 않습니다. 동영상 또는 오디오 형식의 파일만 허용됩니다.","오디오·동영상 파일인지, 손상되지 않았는지 확인하세요."],["424","첨부파일이 없습니다.","파일 필드 이름을 media로 보냈는지 확인하세요."],["424","알 수 없는 이유로 실패했습니다.","파일을 다른 형식으로 다시 저장한 뒤 한 번 더 요청하세요."],["408","처리 시간 초과로 실패했습니다.","data.success가 3입니다. 파일을 나눠 다시 요청하세요."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}