> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# n8n에서 BeatAPI 사용하기

> BeatAPI 모델과 데이터를 n8n에 연결한 다음, 검증 범위가 명확한 작업별 워크플로를 가져옵니다.

# 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 예제](https://github.com/BeatAPI/beatapi-examples/tree/codex/n8n-capabilities/integrations/n8n)에는 기능 워크플로 하나, 공개 Social Data 조사 워크플로 세 개, 뮤직비디오 워크플로 하나가 들어 있습니다. 현재 Social Data 변경 사항은 [PR #20](https://github.com/BeatAPI/beatapi-examples/pull/20)에 있으며, 이 PR은 검토용이고 병합된 릴리스나 n8n Marketplace 목록이 아닙니다.

1. 워크플로 JSON을 내려받아 n8n으로 가져오세요.
2. **Configure Inputs**를 열고 예시 값을 바꾸세요.
3. 모든 BeatAPI HTTP Request 노드에 Header Auth 자격 증명을 지정하세요.
4. 유료 실행 전에 선택한 기능의 입력, 출력, 가격, 실행 지침을 확인하세요.
5. 한 번 실행해 보고 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](https://github.com/BeatAPI/beatapi-examples/pull/20)과 n8n 템플릿 디렉터리에서 확인하세요.

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