Model API
Model API · 빠른 시작
Model API는 하나의 Felo API 키로 앱이나 AI 도구를 여러 공급자의 모델에 연결합니다. 대화, 글쓰기, 코딩에 사용하거나 이미지 및 동영상 모델을 선택할 수 있습니다. 비용은 실제 사용량에 따라 플랫폼 잔액에서 차감됩니다.
빠른 시작
- API Key 받기 — 콘솔에서 API 키를 만들고 전체 키를 복사해 안전하게 보관하세요.
- 잔액 충전 — 달러 기준 서비스 크레딧을 구매하고 실제 API 사용량에 따라 차감합니다. 구독은 필요 없습니다.
- 전체 모델 보기 — 카탈로그에서 Chat Completions를 지원하는 모델을 선택하고 아래 YOUR_MODEL_ID를 해당 ID로 바꾸세요.
AI 도구에서 사용
Codex, Claude Code, OpenClaw, Cursor, Cline 등 Agent 클라이언트를 설정하세요.
Codex
Felo custom model provider로 Codex CLI를 설정하세요.
Claude Code
Anthropic-compatible 모델 호출이 Felo API Platform을 통해 라우팅되도록 Claude Code를 설정하세요.
OpenClaw
assistant 및 Agent 워크플로를 위해 OpenClaw를 Felo API Platform에 연결하세요.
Hermes Agent
Felo API Platform의 모델 접근으로 Hermes Agent를 설정하세요.
OpenCode
OpenAI-compatible endpoint를 통해 OpenCode를 Felo에 연결하세요.
DeepSeek Harness
기본 DeepSeek adapter 또는 custom OpenAI-compatible provider로 DeepSeek Harness를 Felo에 연결하세요.
Cursor
지원되는 custom OpenAI-compatible 설정으로 Cursor에서 Felo API Platform을 사용하세요.
Cline
Felo API Platform의 모델 접근으로 Cline을 설정하세요.
Pi
Install the Felo Skill for Pi and optionally add Felo as a Pi model provider.
TRAE
호환 모델 provider 설정으로 TRAE에서 Felo API Platform을 사용하세요.
Roo Code
Felo-compatible model provider로 Roo Code를 설정하세요.
Kilo Code
Felo API Platform의 모델 접근으로 Kilo Code를 설정하세요.
자체 앱에 연결
기존 OpenAI 또는 Anthropic SDK를 사용할 수 있습니다. 해당 Base URL, Felo API 키, 지원되는 모델 ID를 입력하세요.
OpenAI SDK · Base URL
https://openapi.felo.ai/api/v1Anthropic SDK · Base URL
https://openapi.felo.ai/apiAnthropic SDK는 /v1/messages를 자동으로 추가합니다. Base URL은 /api로 설정하고 /v1을 덧붙이지 마세요. SDK API Key에는 Felo Key를 사용합니다.
빠른 시작 · Chat Completions
카탈로그에서 Chat Completions를 지원하는 모델을 선택하고 아래 YOUR_MODEL_ID를 해당 ID로 바꾸세요.
export FELO_API_KEY="YOUR_FELO_API_KEY"
curl -sS https://openapi.felo.ai/api/v1/chat/completions \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Say hello"}]}'HTTP 200 → choices[0].message.content
프로토콜 및 인증 세부 정보
Felo 호환 모델 및 영상 API입니다. 모델 엔드포인트에는 OpenAI 호환 Models, Chat Completions, Responses API와 Claude 호환 Messages API가 포함됩니다. Felo API 키와 Bearer 인증 또는 X-API-Key 헤더를 사용해 모델 및 영상 요청을 인증합니다. 영상 작업을 비동기로 제출하고 상태가 succeeded가 될 때까지 폴링한 뒤 outputs[]에서 서명된 출력 미디어 URL을 다운로드합니다. 미디어 다운로드 엔드포인트는 익명이며, 각 출력 URL에는 수명이 짧은 HMAC 서명(exp + sig)이 포함되어 API 키 없이 브라우저에서 바로 열 수 있습니다. Chat Completions, Responses, Messages는 각각의 프로토콜 요청, 응답, 스트리밍, 오류 형식을 유지합니다. GET/HEAD /api/platform/model-catalog는 모델 탐색과 Playground 양식을 위한 익명의 로케일 인식 디렉터리입니다. 추론에는 여전히 API 키가 필요합니다. 6개 추론 프로토콜 모두 X-Felo-Channel을 허용하며, 게시된 채널이 라우팅을 제어합니다. 이미지는 영구 비동기 작업을 사용하고 Decisions는 비스트리밍 state/questions를 사용합니다.
인증
Bearer 토큰
FeloBearerAuth
요청 헤더
Authorization: Bearer <FELO_API_KEY>Felo API 키를 Authorization: Bearer <key> 형식으로 전송합니다.
API 키
FeloApiKey
요청 헤더
X-API-Key: <FELO_API_KEY>Felo API 키를 X-API-Key: <key> 형식으로 전송합니다.