> 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. # 연동 가이드 > 기본 URL과 API 키 하나씩만 바꿔 기존 코딩 에이전트, 데스크톱 채팅 클라이언트, LLM 플랫폼을 BeatAPI에 연결하세요. # 연동 가이드 모델 제조사 API와 이미 통신하는 도구는 대부분 BeatAPI와도 통신할 수 있습니다. 코드를 고칠 필요 없이 기본 URL을 바꾸고 BeatAPI 키를 붙여 넣은 뒤 모델 ID를 고르면 됩니다. BeatAPI는 네 가지 요청 형식을 지원하므로 각 도구는 원래 쓰던 형식을 그대로 사용합니다. | 형식 | 엔드포인트 | 이 형식을 쓰는 도구 | | ----------------------- | -------------------------------------- | ----------------------------------------------------------------------------- | | OpenAI Chat Completions | `POST /v1/chat/completions` | Cherry Studio, ChatBox, Cline, Cursor, AnythingLLM, Dify, Immersive Translate | | OpenAI Responses | `POST /v1/responses` | Codex CLI | | Anthropic Messages | `POST /v1/messages` | Claude Code | | Gemini 호환 | `POST /v1beta/models/{model}:{action}` | Gemini SDK 연동 | ## AI 코딩 도구 #### [Claude Code](/integrations/claude-code) `ANTHROPIC_BASE_URL`로 설정하는 터미널 코딩 에이전트. #### [Codex CLI](/integrations/codex-cli) `config.toml`에 BeatAPI를 사용자 지정 모델 제공자로 추가합니다. #### [Gemini CLI](/integrations/gemini-cli) 환경 변수 두 개로 네이티브 Gemini 엔드포인트에 연결합니다. #### [Cline](/integrations/cline) OpenAI Compatible 제공자를 쓰는 VS Code 확장 프로그램. #### [Cursor](/integrations/cursor) 편집기의 모델 설정에서 OpenAI 기본 URL을 재정의합니다. #### [CC-Switch](/integrations/cc-switch) 데스크톱 앱 하나에서 Claude Code와 Codex CLI 제공자를 관리합니다. ## 채팅 클라이언트 #### [Cherry Studio](/integrations/cherry-studio) BeatAPI를 OpenAI 유형 제공자로 추가하고 모델 목록을 불러옵니다. #### [ChatBox](/integrations/chatbox) OpenAI, Claude, Gemini 제공자 유형으로 동작합니다. #### [AnythingLLM](/integrations/anythingllm) 로컬 지식 베이스의 채팅 모델로 BeatAPI를 사용합니다. ## 플랫폼 #### [n8n](/integrations/n8n) 내장 모델·HTTP 노드와 작업별 워크플로 내보내기 파일을 사용합니다. #### [Dify](/integrations/dify) 텍스트 모델을 설정하고, 액션에는 별도 버전으로 관리되는 도구 플러그인을 사용합니다. #### [Zapier](/integrations/zapier) 공개 모델, Social Data, 기능, 미디어 액션을 사용합니다. #### [Make](/integrations/make) 공유 가능한 미디어 템플릿으로 시작하거나 HTTP 시나리오를 만듭니다. #### [Immersive Translate](/integrations/immersive-translate) 브라우저 확장 프로그램에 BeatAPI를 사용자 지정 번역 서비스로 추가합니다. ## 모든 가이드의 공통 사항 세 가지 값은 어디서나 같습니다. 위 목록에 없는 도구라면 OpenAI 호환 옵션에 다음 값을 넣어 보세요. | 설정 | 값 | | -------- | -------------------------------------------------------------------------------------- | | Base URL | OpenAI 호환 도구는 `https://api.beatapi.io/v1`, Anthropic 네이티브 도구는 `https://api.beatapi.io` | | API 키 | [대시보드 → API Keys](https://beatapi.io/dashboard/apikeys)에서 만든 키 | | 모델 ID | [`GET /v1/models`](/text-api) 또는 [가격 페이지](https://beatapi.io/pricing)의 아무 ID | > **Note** > > `/v1` 접미사가 헷갈리는 곳은 기본 URL뿐입니다. OpenAI SDK 관례를 따르는 도구는 `https://api.beatapi.io/v1`을, Anthropic SDK 기반 도구는 `https://api.beatapi.io`를 쓰며 `/v1/messages`를 직접 붙입니다. 각 가이드에 어느 쪽인지 적혀 있습니다. ## 모델 선택 모든 연동은 같은 키로 같은 모델 목록에 접근합니다. 아래는 무난한 출발점이며, 계열별 전체 목록은 [텍스트 API](/text-api) 페이지에 있습니다. | 용도 | 모델 ID | | ---------- | ---------------------------------------------------------------- | | 에이전트 코딩 | `claude-fable-5-1`, `gpt-5.6-sol` | | 어려운 추론 | `claude-opus-5`, `gpt-6-astra`, `deepseek-v4-pro-0813` | | 일상적인 대화 | `claude-sonnet-5`, `gpt-5.6-terra`, `glm-5.3` | | 대량 처리, 저비용 | `claude-haiku-4-5-20251001`, `gemini-3.7-flash`, `glm-5.3-flash` | | 긴 컨텍스트 | `minimax-m3`, `grok-4.7` | ## 키 안전하게 관리하기 * 도구마다 키를 따로 만들어, 하나를 폐기해도 다른 도구에 영향이 없게 하세요. * 커밋될 수 있는 설정 파일에 값을 붙여 넣기보다 환경 변수를 사용하세요. * 키가 들어 있는 설정 파일은 `.gitignore`에 추가하세요. * [`GET /v1/usage`](/quick-guide)의 `by_api_key`나 대시보드에서 키별 지출을 확인하세요.