# 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-CN/models) — 从模型目录选择支持 Chat Completions 的模型，将下面的 YOUR_MODEL_ID 替换成它的模型 ID。

## 在 AI 工具里使用

配置 Codex、Claude Code、DeepSeek Harness、OpenClaw、Cursor、Cline 等 Agent 客户端。

- [Codex](https://openapi.felo.ai/zh-CN/docs/agent-clients/codex.md) — 使用 Felo 自定义模型 provider 配置 Codex CLI。
- [Claude Code](https://openapi.felo.ai/zh-CN/docs/agent-clients/claude-code.md) — 配置 Claude Code，让 Anthropic-compatible 模型调用通过 Felo API Platform 路由。
- [OpenClaw](https://openapi.felo.ai/zh-CN/docs/agent-clients/openclaw.md) — 把 OpenClaw 接入 Felo API Platform，用于 assistant 与 agent 工作流。
- [Hermes Agent](https://openapi.felo.ai/zh-CN/docs/agent-clients/hermes-agent.md) — 使用 Felo API Platform 模型访问配置 Hermes Agent。
- [OpenCode](https://openapi.felo.ai/zh-CN/docs/agent-clients/opencode.md) — 通过 OpenAI-compatible endpoint 将 OpenCode 连接到 Felo。
- [DeepSeek Harness](https://openapi.felo.ai/zh-CN/docs/agent-clients/deepseek-harness.md) — 通过原生 DeepSeek 适配器或自定义 OpenAI-compatible provider 将 DeepSeek Harness 接入 Felo。
- [Cursor](https://openapi.felo.ai/zh-CN/docs/agent-clients/cursor.md) — 在支持自定义 OpenAI-compatible 设置的 Cursor 中使用 Felo API Platform。
- [Cline](https://openapi.felo.ai/zh-CN/docs/agent-clients/cline.md) — 使用 Felo API Platform 模型访问配置 Cline。
- [Pi](https://openapi.felo.ai/zh-CN/docs/agent-clients/pi.md) — 为 Pi 安装 Felo Skill；也可以把 Felo 配成 Pi 的模型 provider。
- [TRAE](https://openapi.felo.ai/zh-CN/docs/agent-clients/trae.md) — 通过兼容模型 provider 设置，在 TRAE 中使用 Felo API Platform。
- [Roo Code](https://openapi.felo.ai/zh-CN/docs/agent-clients/roo-code.md) — 使用 Felo-compatible 模型 provider 配置 Roo Code。
- [Kilo Code](https://openapi.felo.ai/zh-CN/docs/agent-clients/kilo-code.md) — 使用 Felo API Platform 模型访问配置 Kilo Code。

[其他 AI 工具](https://openapi.felo.ai/zh-CN/docs/agent-clients/other-tools.md) · [FeloAPI CLI](https://openapi.felo.ai/zh-CN/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-CN/docs/getting-started.md) · [协议与 SDK](https://openapi.felo.ai/zh-CN/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 使用非流式 state/questions。