# Model API · 빠른 시작

Model API는 하나의 Felo API 키로 앱이나 AI 도구를 여러 공급자의 모델에 연결합니다. 대화, 글쓰기, 코딩에 사용하거나 이미지 및 동영상 모델을 선택할 수 있습니다. 비용은 실제 사용량에 따라 플랫폼 잔액에서 차감됩니다.

## 빠른 시작

1. [API Key 받기](https://openapi.felo.ai/console/api-keys) — 콘솔에서 API 키를 만들고 전체 키를 복사해 안전하게 보관하세요.
2. [잔액 충전](https://openapi.felo.ai/console/billing) — 달러 기준 서비스 크레딧을 구매하고 실제 API 사용량에 따라 차감합니다. 구독은 필요 없습니다.
3. [전체 모델 보기](https://openapi.felo.ai/ko/models) — 카탈로그에서 Chat Completions를 지원하는 모델을 선택하고 아래 YOUR_MODEL_ID를 해당 ID로 바꾸세요.

## AI 도구에서 사용

Codex, Claude Code, OpenClaw, Cursor, Cline 등 Agent 클라이언트를 설정하세요.

- [Codex](https://openapi.felo.ai/ko/docs/agent-clients/codex.md) — Felo custom model provider로 Codex CLI를 설정하세요.
- [Claude Code](https://openapi.felo.ai/ko/docs/agent-clients/claude-code.md) — Anthropic-compatible 모델 호출이 Felo API Platform을 통해 라우팅되도록 Claude Code를 설정하세요.
- [OpenClaw](https://openapi.felo.ai/ko/docs/agent-clients/openclaw.md) — assistant 및 Agent 워크플로를 위해 OpenClaw를 Felo API Platform에 연결하세요.
- [Hermes Agent](https://openapi.felo.ai/ko/docs/agent-clients/hermes-agent.md) — Felo API Platform의 모델 접근으로 Hermes Agent를 설정하세요.
- [OpenCode](https://openapi.felo.ai/ko/docs/agent-clients/opencode.md) — OpenAI-compatible endpoint를 통해 OpenCode를 Felo에 연결하세요.
- [DeepSeek Harness](https://openapi.felo.ai/ko/docs/agent-clients/deepseek-harness.md) — 기본 DeepSeek adapter 또는 custom OpenAI-compatible provider로 DeepSeek Harness를 Felo에 연결하세요.
- [Cursor](https://openapi.felo.ai/ko/docs/agent-clients/cursor.md) — 지원되는 custom OpenAI-compatible 설정으로 Cursor에서 Felo API Platform을 사용하세요.
- [Cline](https://openapi.felo.ai/ko/docs/agent-clients/cline.md) — Felo API Platform의 모델 접근으로 Cline을 설정하세요.
- [Pi](https://openapi.felo.ai/ko/docs/agent-clients/pi.md) — Install the Felo Skill for Pi and optionally add Felo as a Pi model provider.
- [TRAE](https://openapi.felo.ai/ko/docs/agent-clients/trae.md) — 호환 모델 provider 설정으로 TRAE에서 Felo API Platform을 사용하세요.
- [Roo Code](https://openapi.felo.ai/ko/docs/agent-clients/roo-code.md) — Felo-compatible model provider로 Roo Code를 설정하세요.
- [Kilo Code](https://openapi.felo.ai/ko/docs/agent-clients/kilo-code.md) — Felo API Platform의 모델 접근으로 Kilo Code를 설정하세요.

[기타 AI 도구](https://openapi.felo.ai/ko/docs/agent-clients/other-tools.md) · [FeloAPI CLI](https://openapi.felo.ai/ko/docs/cli.md)

## 자체 앱에 연결

기존 OpenAI 또는 Anthropic SDK를 사용할 수 있습니다. 해당 Base URL, Felo API 키, 지원되는 모델 ID를 입력하세요.

### OpenAI SDK · Base URL

```text
https://openapi.felo.ai/api/v1
```

### Anthropic SDK · Base URL

```text
https://openapi.felo.ai/api
```

Anthropic SDK는 /v1/messages를 자동으로 추가합니다. Base URL은 /api로 설정하고 /v1을 덧붙이지 마세요. SDK API Key에는 Felo Key를 사용합니다.

### 빠른 시작 · Chat Completions

카탈로그에서 Chat Completions를 지원하는 모델을 선택하고 아래 YOUR_MODEL_ID를 해당 ID로 바꾸세요.

```bash
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`

[수동으로 설정](https://openapi.felo.ai/ko/docs/getting-started.md) · [프로토콜 및 SDK](https://openapi.felo.ai/ko/docs/guides/protocols.md)

## 프로토콜 및 인증 세부 정보

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를 사용합니다.