연동 가이드

모델 제조사 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

ANTHROPIC_BASE_URL로 설정하는 터미널 코딩 에이전트.

Codex CLI

config.toml에 BeatAPI를 사용자 지정 모델 제공자로 추가합니다.

Gemini CLI

환경 변수 두 개로 네이티브 Gemini 엔드포인트에 연결합니다.

Cline

OpenAI Compatible 제공자를 쓰는 VS Code 확장 프로그램.

Cursor

편집기의 모델 설정에서 OpenAI 기본 URL을 재정의합니다.

CC-Switch

데스크톱 앱 하나에서 Claude Code와 Codex CLI 제공자를 관리합니다.

채팅 클라이언트

Cherry Studio

BeatAPI를 OpenAI 유형 제공자로 추가하고 모델 목록을 불러옵니다.

ChatBox

OpenAI, Claude, Gemini 제공자 유형으로 동작합니다.

AnythingLLM

로컬 지식 베이스의 채팅 모델로 BeatAPI를 사용합니다.

플랫폼

n8n

내장 모델·HTTP 노드와 작업별 워크플로 내보내기 파일을 사용합니다.

Dify

텍스트 모델을 설정하고, 액션에는 별도 버전으로 관리되는 도구 플러그인을 사용합니다.

Zapier

공개 모델, Social Data, 기능, 미디어 액션을 사용합니다.

Make

공유 가능한 미디어 템플릿으로 시작하거나 HTTP 시나리오를 만듭니다.

Immersive Translate

브라우저 확장 프로그램에 BeatAPI를 사용자 지정 번역 서비스로 추가합니다.

모든 가이드의 공통 사항

세 가지 값은 어디서나 같습니다. 위 목록에 없는 도구라면 OpenAI 호환 옵션에 다음 값을 넣어 보세요.

설정	값
Base URL	OpenAI 호환 도구는 `https://api.beatapi.io/v1`, Anthropic 네이티브 도구는 `https://api.beatapi.io`
API 키	대시보드 → API Keys에서 만든 키
모델 ID	`GET /v1/models` 또는 가격 페이지의 아무 ID

/v1 접미사가 헷갈리는 곳은 기본 URL뿐입니다. OpenAI SDK 관례를 따르는 도구는 https://api.beatapi.io/v1을, Anthropic SDK 기반 도구는 https://api.beatapi.io를 쓰며 /v1/messages를 직접 붙입니다. 각 가이드에 어느 쪽인지 적혀 있습니다.

모델 선택

모든 연동은 같은 키로 같은 모델 목록에 접근합니다. 아래는 무난한 출발점이며, 계열별 전체 목록은 텍스트 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의 by_api_key나 대시보드에서 키별 지출을 확인하세요.