# Model API · クイックスタート

Model API は、1 つの 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/ja/models) — カタログから Chat Completions 対応モデルを選び、以下の YOUR_MODEL_ID をその ID に置き換えてください。

## AI ツールで使う

Codex、Claude Code、OpenClaw、Cursor、Cline などの Agent クライアントを設定します。

- [Codex](https://openapi.felo.ai/ja/docs/agent-clients/codex.md) — Felo のカスタムモデル provider で Codex CLI を設定します。
- [Claude Code](https://openapi.felo.ai/ja/docs/agent-clients/claude-code.md) — Anthropic-compatible なモデル呼び出しを Felo API Platform 経由にするよう Claude Code を設定します。
- [OpenClaw](https://openapi.felo.ai/ja/docs/agent-clients/openclaw.md) — assistant と Agent ワークフローのために OpenClaw を Felo API Platform に接続します。
- [Hermes Agent](https://openapi.felo.ai/ja/docs/agent-clients/hermes-agent.md) — Felo API Platform のモデルアクセスで Hermes Agent を設定します。
- [OpenCode](https://openapi.felo.ai/ja/docs/agent-clients/opencode.md) — OpenAI-compatible endpoint で OpenCode を Felo に接続します。
- [DeepSeek Harness](https://openapi.felo.ai/ja/docs/agent-clients/deepseek-harness.md) — 標準の DeepSeek adapter またはカスタム OpenAI-compatible provider で DeepSeek Harness を Felo に接続します。
- [Cursor](https://openapi.felo.ai/ja/docs/agent-clients/cursor.md) — 利用可能なカスタム OpenAI-compatible 設定で Cursor から Felo API Platform を使います。
- [Cline](https://openapi.felo.ai/ja/docs/agent-clients/cline.md) — Felo API Platform のモデルアクセスで Cline を設定します。
- [Pi](https://openapi.felo.ai/ja/docs/agent-clients/pi.md) — Pi に Felo Skill をインストールします。必要なら Felo を Pi のモデル provider として追加できます。
- [TRAE](https://openapi.felo.ai/ja/docs/agent-clients/trae.md) — 互換モデル provider 設定で TRAE から Felo API Platform を使います。
- [Roo Code](https://openapi.felo.ai/ja/docs/agent-clients/roo-code.md) — Felo-compatible なモデル provider で Roo Code を設定します。
- [Kilo Code](https://openapi.felo.ai/ja/docs/agent-clients/kilo-code.md) — Felo API Platform のモデルアクセスで Kilo Code を設定します。

[その他の AI ツール](https://openapi.felo.ai/ja/docs/agent-clients/other-tools.md) · [FeloAPI CLI](https://openapi.felo.ai/ja/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/ja/docs/getting-started.md) · [プロトコルと SDK](https://openapi.felo.ai/ja/docs/guides/protocols.md)

## プロトコルと認証の詳細

Felo 互換のモデル API と動画 API です。モデル関連のエンドポイントには、OpenAI 互換の Models、Chat Completions、Responses API に加え、Claude 互換の Messages API が含まれます。モデルおよび動画のリクエストは、Bearer 認証または X-API-Key ヘッダーを使った Felo APIキーで認証します。動画タスクは非同期で送信し、status が 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 を使用します。