> 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. # 모델과 기능 > BeatAPI가 제공하는 모델, 사용할 수 있는 요청 형식, 의도적으로 제공하지 않는 기능, 그리고 API 출력이 채팅 서비스와 다른 이유를 설명합니다. # 모델과 기능 ## BeatAPI는 무엇을 제공하나요? | 카테고리 | 제공 범위 | | ---- | -------------------------------------------------------------------------- | | 텍스트 | 키 하나로 사용하는 12개 모델 계열. [텍스트 API](/text-api) 참고 | | 이미지 | 비동기 생성과 편집. [이미지 API](/image-api) 참고 | | 영상 | 모션 컨트롤을 포함한 비동기 생성. [영상 API](/video-api) 참고 | | 워크플로 | Music Video, Ecommerce Video, Video Analysis. [워크플로 API](/workflow-api) 참고 | | 이펙트 | 공개된 원샷 이펙트. [이펙트 API](/effect-api) 참고 | | 실시간 | WebRTC로 실시간 생성하는 영상. [실시간 API](/realtime-api) 참고 | `GET /v1/models`는 계정에서 사용할 수 있는 텍스트 모델을 반환합니다. 전체 목록과 현재 요금은 [가격 페이지](https://beatapi.io/pricing)에 있습니다. ## 어떤 요청 형식을 사용할 수 있나요? 네 가지 요청 형식을 사용할 수 있습니다. 지원되는 형식은 선택한 모델 계열에 따라 다릅니다. | 형식 | 엔드포인트 | | ----------------------- | -------------------------------------- | | 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](/integrations/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를 즉시 반환하고, 결과가 준비되면 가져오는 방식입니다. 실패한 작업은 환불되는데, 동기식 호출로는 이를 깔끔하게 표현할 방법이 없습니다. 수명 주기는 [개발 가이드](/development)를, 폴링을 피하는 방법은 [웹훅](/webhooks)을 참고하세요. ## API 응답이 채팅 서비스와 다른 이유는 무엇인가요? 일반 사용자용 채팅 서비스는 모델을 중심으로 만든 애플리케이션입니다. API는 모델 자체를 제공합니다. 채팅 서비스가 추가로 제공하며 API에서는 기본으로 제공되지 않는 것은 다음과 같습니다. * 웹 검색 등 실시간 도구 * 세션 간 대화 기억 * 코드 실행 샌드박스 * 조정된 시스템 프롬프트 * 업로드한 파일에 대한 검색 API에서는 대화 기록을 직접 관리하고, 시스템 프롬프트를 직접 정하며, 필요하면 도구 호출을 직접 연결합니다. 빠진 것은 없습니다. 조립은 사용자의 몫입니다. ## 모델이 이미지, 도구, 스트리밍을 지원하나요? 모든 텍스트 모델에서 `stream: true`로 스트리밍할 수 있습니다. 비전과 도구 호출 지원은 모델마다 다릅니다. 이전 `deepseek-v4-flash-vision-exp` 경로는 현재 BeatAPI 카탈로그에 없으며, Claude, GPT, Gemini 계열은 대부분 멀티모달을 지원합니다. 특정 기능을 전제로 설계하기 전에 [텍스트 API](/text-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 계열은 컨텍스트가 일정 기준을 넘으면 더 높은 요금이 적용됩니다. 정확한 시간과 기준은 [가격 페이지](https://beatapi.io/pricing) 각주에 있습니다. 각 응답의 사용량 기록에서 어떤 요금이 적용되었는지 확인할 수 있습니다. ## 다른 곳에서 이미 결제한 모델을 사용할 수 있나요? BeatAPI는 하나의 계정과 하나의 잔액으로 운영됩니다. 다른 업체에서 발급받은 키를 연결하는 방식은 제공하지 않습니다.