모델과 기능

BeatAPI는 무엇을 제공하나요?

카테고리	제공 범위
텍스트	키 하나로 사용하는 12개 모델 계열. 텍스트 API 참고
이미지	비동기 생성과 편집. 이미지 API 참고
영상	모션 컨트롤을 포함한 비동기 생성. 영상 API 참고
워크플로	Music Video, Ecommerce Video, Video Analysis. 워크플로 API 참고
이펙트	공개된 원샷 이펙트. 이펙트 API 참고
실시간	WebRTC로 실시간 생성하는 영상. 실시간 API 참고

GET /v1/models는 계정에서 사용할 수 있는 텍스트 모델을 반환합니다. 전체 목록과 현재 요금은 가격 페이지에 있습니다.

어떤 요청 형식을 사용할 수 있나요?

네 가지 요청 형식을 사용할 수 있습니다. 지원되는 형식은 선택한 모델 계열에 따라 다릅니다.

형식	엔드포인트
OpenAI Chat Completions	`POST /v1/chat/completions`
OpenAI Responses	`POST /v1/responses`
Anthropic Messages	`POST /v1/messages`
Gemini 호환	`POST /v1beta/models/{model}:{action}`

GPT는 Chat Completions 또는 Responses, Claude는 Messages, Gemini는 네 가지 형식 모두, 그 밖의 계열은 Chat Completions, Responses, Messages를 사용하세요. 모든 모델이 모든 형식을 지원한다고 가정하지 말고 선택한 계열의 레퍼런스를 따르세요.

의도적으로 제공하지 않는 것은 무엇인가요?

/v1/embeddings, /v1/rerank, /v1/audio/*는 404를 반환합니다. 아직 준비되지 않은 기능이 아니라, 공개 범위에 포함되지 않는 기능입니다.

실제로는 채팅 모델과 함께 임베딩 모델이 필요한 도구(대표적으로 AnythingLLM)의 임베더를 다른 곳, 보통 도구에 기본 포함된 로컬 임베더로 지정해야 한다는 뜻입니다.

이미지·영상 생성은 OpenAI와 호환되나요?

아니요. 의도적으로 그렇게 설계했습니다. BeatAPI의 생성 API는 비동기 작업 기반입니다.

POST /v1/images/tasks   ->  201, { "data": { "id": "..." } }
GET  /v1/tasks/{id}     ->  poll until succeeded or failed

동기식 /v1/images/generations는 없습니다. 몇 분씩 걸리는 모델은 진행 상황을 속이거나 시간 초과되지 않고서는 HTTP 요청 하나 안에서 응답할 수 없습니다. 그래서 작업 ID를 즉시 반환하고, 결과가 준비되면 가져오는 방식입니다. 실패한 작업은 환불되는데, 동기식 호출로는 이를 깔끔하게 표현할 방법이 없습니다.

수명 주기는 개발 가이드를, 폴링을 피하는 방법은 웹훅을 참고하세요.

API 응답이 채팅 서비스와 다른 이유는 무엇인가요?

일반 사용자용 채팅 서비스는 모델을 중심으로 만든 애플리케이션입니다. API는 모델 자체를 제공합니다.

채팅 서비스가 추가로 제공하며 API에서는 기본으로 제공되지 않는 것은 다음과 같습니다.

웹 검색 등 실시간 도구
세션 간 대화 기억
코드 실행 샌드박스
조정된 시스템 프롬프트
업로드한 파일에 대한 검색

API에서는 대화 기록을 직접 관리하고, 시스템 프롬프트를 직접 정하며, 필요하면 도구 호출을 직접 연결합니다. 빠진 것은 없습니다. 조립은 사용자의 몫입니다.

모델이 이미지, 도구, 스트리밍을 지원하나요?

모든 텍스트 모델에서 stream: true로 스트리밍할 수 있습니다.

비전과 도구 호출 지원은 모델마다 다릅니다. 이전 deepseek-v4-flash-vision-exp 경로는 현재 BeatAPI 카탈로그에 없으며, Claude, GPT, Gemini 계열은 대부분 멀티모달을 지원합니다. 특정 기능을 전제로 설계하기 전에 텍스트 API에서 해당 모델 페이지를 확인하세요.

모델은 어떻게 고르나요?

용도	추천 시작 모델
에이전트 코딩	`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`, `kimi-k3`
중국어 작업	`qwen3.8-max`, `glm-5.3`, `hy4-preview`

모델 ID는 고정되어 있습니다. 계열에 새 세대가 나오면 새 ID가 부여되며, 기존 ID가 몰래 다른 가중치를 가리키도록 바뀌지 않습니다.

시간대나 컨텍스트 길이에 따라 가격이 바뀌나요?

일부 모델은 그렇습니다. 두 경우 모두 공개되어 있습니다.

피크 시간대 — DeepSeek HC(high-cache) 모델 두 개는 평일 베이징 시간 09:00–12:00와 14:00–18:00에 요금이 두 배가 되며, 일반 유료 DeepSeek 모델은 시간과 관계없이 같은 요금입니다. Hunyuan hy3에는 별도의 일일 시간대가 있습니다.
컨텍스트 구간 — GPT-5.6 계열과 Grok 계열은 컨텍스트가 일정 기준을 넘으면 더 높은 요금이 적용됩니다.

정확한 시간과 기준은 가격 페이지 각주에 있습니다. 각 응답의 사용량 기록에서 어떤 요금이 적용되었는지 확인할 수 있습니다.

다른 곳에서 이미 결제한 모델을 사용할 수 있나요?

BeatAPI는 하나의 계정과 하나의 잔액으로 운영됩니다. 다른 업체에서 발급받은 키를 연결하는 방식은 제공하지 않습니다.