n8n에서 BeatAPI 사용하기

작업에 맞는 진입점을 고르세요. 모델 자격 증명, HTTP 워크플로, 게시된 n8n 템플릿은 서로 다릅니다.

작업	n8n 진입점	BeatAPI 기능
AI Agent 또는 LLM Chain의 텍스트	내장 OpenAI Chat Model	`https://api.beatapi.io/v1`과 `GET /v1/models`의 정확한 ID
Social Data 또는 웹 조사	Header Auth를 쓰는 HTTP Request	확인한 기능 또는 문서화된 Data/Web 엔드포인트
이미지, 영상 또는 뮤직비디오	HTTP Request, Wait, 횟수 제한이 있는 상태 확인 루프	한 번 생성하고 작업 ID를 보관한 뒤 상태를 폴링

자격 증명 설정

OpenAI Chat Model에는 BeatAPI 키와 기본 URL https://api.beatapi.io/v1으로 OpenAI 자격 증명을 만드세요. HTTP Request 노드에는 헤더 Authorization, 값 Bearer <your BeatAPI key>로 Header Auth 자격 증명을 만드세요. 실제 키는 내보낸 JSON이 아니라 n8n 자격 증명에만 보관하세요.

워크플로 가져오기

BeatAPI n8n 예제에는 기능 워크플로 하나, 공개 Social Data 조사 워크플로 세 개, 뮤직비디오 워크플로 하나가 들어 있습니다. 현재 Social Data 변경 사항은 PR #20에 있으며, 이 PR은 검토용이고 병합된 릴리스나 n8n Marketplace 목록이 아닙니다.

워크플로 JSON을 내려받아 n8n으로 가져오세요.
Configure Inputs를 열고 예시 값을 바꾸세요.
모든 BeatAPI HTTP Request 노드에 Header Auth 자격 증명을 지정하세요.
유료 실행 전에 선택한 기능의 입력, 출력, 가격, 실행 지침을 확인하세요.
한 번 실행해 보고 BeatAPI 요청 ID나 작업 ID를 n8n 실행 ID와 함께 보관하세요.

비동기 작업에서는 과금되는 작업을 새로 만들지 말고 상태 조회만 재시도하세요. 성공, 실패 또는 정해 둔 시간 초과에서 루프를 끝내세요. n8n에서 시간이 초과되었다고 BeatAPI 작업이 실패한 것은 아닙니다.

검증 상태

2026년 9월 26일 기준으로 Social Data JSON 파일 세 개를 로컬 n8n 인스턴스로 가져왔습니다. X 키워드 워크플로는 로컬 n8n 실행을 마쳤고, Instagram과 YouTube는 API 확인과 가져오기 확인을 거쳤지만 n8n 전체 실행은 하지 않았습니다. X 템플릿은 사람의 검토를 위해 n8n Creator Portal에 제출되었습니다. 최신 배포 상태는 PR #20과 n8n 템플릿 디렉터리에서 확인하세요.

이 예제는 내장 노드만으로 사용할 수 있습니다. BeatAPI는 전용 n8n 커뮤니티 노드를 게시하지 않았습니다.