> 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.

# Zapier에서 BeatAPI 사용하기

> 공개 BeatAPI Zapier 앱을 연결하고, 현재 사용할 수 있는 액션을 확인합니다.

# Zapier에서 BeatAPI 사용하기

[Zapier의 공개 BeatAPI 앱](https://zapier.com/apps/beatapi/integrations)은 현재 승격된 버전 1.1.0을 사용합니다. 공개 액션 목록은 다음과 같습니다.

| 액션                                            | 결과                                                        |
| --------------------------------------------- | --------------------------------------------------------- |
| Create Music Video Task                       | 공개 이미지·오디오 URL로 비동기 작업을 하나 만들고 작업 ID를 반환합니다.              |
| Find Task                                     | 기존 작업 ID의 현재 상태와 출력을 읽습니다.                                |
| Generate Text, Generate Image, Generate Video | 선택한 BeatAPI 모델을 호출합니다. 이미지와 영상 생성은 비동기 작업 ID를 반환할 수 있습니다. |
| Get Social Data                               | 선택한 Social Data 액션을 호출하며, 크레딧이 소비될 수 있습니다.                |
| Search Capabilities, Inspect Capability       | 기능을 찾고 실행 전에 현재 계약을 읽습니다.                                 |
| Run Capability, Get Capability Result         | 지원되는 기능을 시작하거나 저장된 결과를 가져옵니다.                             |

## Zap 만들기

1. **BeatAPI → Create Music Video Task**를 추가하고 전용 BeatAPI API 키를 연결하세요.
2. 필수 공개 HTTPS 이미지·오디오 URL과 크리에이티브 프롬프트를 매핑하세요.
3. 액션을 테스트하고 다음 단계에서 작업 ID를 저장하세요.
4. **BeatAPI → Find Task** 앞에 **Delay by Zapier**를 두세요. 작업이 성공하거나 실패할 때까지 횟수를 제한한 일정이나 이후 Zap으로 반복하세요.
5. 호스팅된 출력은 작업이 성공한 뒤에만 사용하세요. 실패하거나 시간이 초과된 실행은 대조할 수 있도록 남겨 두세요.

텍스트, 이미지, 영상, Social Data는 해당 BeatAPI 액션을 선택하고 Zap 편집기에서 필드를 테스트하세요. 동적 기능은 Search의 `reference`를 그대로 Inspect에 넘기고, Inspect가 실행을 지원한다고 알릴 때만 Run을 사용하세요. 그 밖의 기능은 요금제에 따라 Zapier의 HTTP/Webhooks 도구로 [BeatAPI API 레퍼런스](/api-reference)를 호출할 수 있습니다. 2026년 9월 26일에 승격된 v1.1.0에서 Zapier 원격 호출로 Search, Inspect, 짧은 Generate Text 호출이 성공했습니다. 다른 모델과 필드 매핑은 아직 별도의 실행 확인이 필요합니다.

API 키는 Zapier 연결에 보관하세요. **Create** 단계가 성공했다는 것은 작업이 수락되었다는 뜻이지 미디어가 완성되었다는 뜻이 아닙니다. 후속 전달이나 게시 전에 작업 상태를 확인하세요.