ガイド
プラットフォーム概要
Model API、Data API、Felo APIs の 3 つの層がどう分担するかと、どこから始めるかを説明します。
Felo API Platform では、1 つの API key で 3 つの異なるリクエスト面を利用できます。いずれも同じアカウント、クレジット、key を共有しますが、解決する課題が異なり、base URL も異なります。
3 つの API
| API | Base URL | 用途 | リファレンス |
|---|---|---|---|
| Model API | https://openapi.felo.ai/api/v1（OpenAI-compatible）と https://openapi.felo.ai/api（Anthropic-compatible） | 言語・画像・動画・意思決定モデルを直接呼び出す | Model API |
| Data API | https://openapi.felo.ai/v1/beta | 名前付きのサードパーティデータ・検索プロバイダーを呼び出す | Data API |
| Felo APIs | https://openapi.felo.ai/v2 | Felo 独自の検索、オフィス、コンテンツ、抽出、ナレッジワークフローを利用する | Felo API reference |
どの API を使うべきか
| やりたいこと | 使う API |
|---|---|
| 自分のコードや AI コーディングツールから LLM を実行する | Model API |
| Web 検索・引用・query 分析付きの回答を得る | Chat API（/v2/chat） |
| スライド、landing page、mindmap、動画を生成する | 対応する Felo task または model endpoint |
| ナレッジベースを構築して検索する | LiveDoc API |
| Tavily、Exa、Apollo などのデータプロバイダーを呼び出す | Data API |
| モデルを特定の上流プロバイダーに固定する | X-Felo-Channel を付けた Model API |
共通のセットアップ
- Felo API Platform コンソールで API key を 1 つ作成します。
Authorization: Bearer $FELO_API_KEYとして送信します。- 利用量に応じて米ドル建てのサービス利用枠をチャージします。
- 呼び出す API に応じた base URL を選びます。
同じ key は、ここで説明するすべての API で使えます。環境ごとに別の key を使うと、一方に影響を与えずに他方をローテーションできます。
プラットフォームが提供するもの
- モデルやデータプロバイダーごとに個別アカウントを持つ代わりに、1 つの key。
- モデル ID、context 上限、プロトコル、料金を含む公開モデルカタログ。
- 複数チャネルで利用できるモデルについて、プロバイダーごとの公開価格。
- コンソールで一元管理できる利用量と課金。
次のステップ
- モデルと料金 — カタログを読み、リクエストを概算する。
- チャネルとプロバイダールーティング — モデルをプロバイダーに固定する。
- プロトコルと SDK — OpenAI-compatible、Responses、Messages を選ぶ。
- 非同期タスク — PPT、landing page、動画、エクスポートのジョブを扱う。
- Data API 概要 — 共通プレフィックス経由でサードパーティの endpoint を呼び出す。