# Model API · 快速接入

Model API 讓你的應用程式或 AI 工具用一把 Felo API Key 呼叫不同供應商的模型。可以用來聊天、寫作、程式開發，也可以選擇圖片或影片模型進行創作。費用依實際用量從平台餘額扣除。

## 快速接入

1. [取得 API Key](https://openapi.felo.ai/console/api-keys) — 在控制台建立 API Key，複製完整金鑰並妥善保存。
2. [儲值餘額](https://openapi.felo.ai/console/billing) — 支援支付寶、微信支付儲值服務額度。額度以美元計價，依實際 API 用量扣減，無需訂閱。
3. [查看全部模型](https://openapi.felo.ai/zh-TW/models) — 從模型目錄選擇支援 Chat Completions 的模型，將下方的 YOUR_MODEL_ID 換成該模型的 ID。

## 在 AI 工具裡使用

設定 Codex、Claude Code、DeepSeek Harness、OpenClaw、Cursor、Cline 等 Agent 用戶端。

- [Codex](https://openapi.felo.ai/zh-TW/docs/agent-clients/codex.md) — 使用 Felo 自訂模型 provider 設定 Codex CLI。
- [Claude Code](https://openapi.felo.ai/zh-TW/docs/agent-clients/claude-code.md) — 設定 Claude Code，讓 Anthropic-compatible 模型呼叫透過 Felo API Platform 路由。
- [OpenClaw](https://openapi.felo.ai/zh-TW/docs/agent-clients/openclaw.md) — 把 OpenClaw 接入 Felo API Platform，用於 assistant 與 agent 工作流程。
- [Hermes Agent](https://openapi.felo.ai/zh-TW/docs/agent-clients/hermes-agent.md) — 使用 Felo API Platform 模型存取設定 Hermes Agent。
- [OpenCode](https://openapi.felo.ai/zh-TW/docs/agent-clients/opencode.md) — 透過 OpenAI-compatible endpoint 將 OpenCode 連接到 Felo。
- [DeepSeek Harness](https://openapi.felo.ai/zh-TW/docs/agent-clients/deepseek-harness.md) — 透過原生 DeepSeek adapter 或自訂 OpenAI-compatible provider 將 DeepSeek Harness 接入 Felo。
- [Cursor](https://openapi.felo.ai/zh-TW/docs/agent-clients/cursor.md) — 在支援自訂 OpenAI-compatible 設定的 Cursor 中使用 Felo API Platform。
- [Cline](https://openapi.felo.ai/zh-TW/docs/agent-clients/cline.md) — 使用 Felo API Platform 模型存取設定 Cline。
- [Pi](https://openapi.felo.ai/zh-TW/docs/agent-clients/pi.md) — 為 Pi 安裝 Felo Skill；也可以把 Felo 設成 Pi 的模型 provider。
- [TRAE](https://openapi.felo.ai/zh-TW/docs/agent-clients/trae.md) — 透過相容模型 provider 設定，在 TRAE 中使用 Felo API Platform。
- [Roo Code](https://openapi.felo.ai/zh-TW/docs/agent-clients/roo-code.md) — 使用 Felo-compatible 模型 provider 設定 Roo Code。
- [Kilo Code](https://openapi.felo.ai/zh-TW/docs/agent-clients/kilo-code.md) — 使用 Felo API Platform 模型存取設定 Kilo Code。

[其他 AI 工具](https://openapi.felo.ai/zh-TW/docs/agent-clients/other-tools.md) · [FeloAPI CLI](https://openapi.felo.ai/zh-TW/docs/cli.md)

## 串接自己的應用程式

已有 OpenAI 或 Anthropic SDK？填入對應的 Base URL、Felo API Key 和支援的模型 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/zh-TW/docs/getting-started.md) · [協議與 SDK](https://openapi.felo.ai/zh-TW/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 金鑰。全部六種推論協定都接受 X-Felo-Channel；已發布的頻道會控制路由。圖片使用持久的非同步任務，Decisions 則使用非串流的狀態／問題。