# Felo APIs の概要

Felo workflows under /v2, called with Felo Pro credits. Compare them with platform-balance APIs.

Web 検索、Web 読み取り、X データ、Chat、または PPT を **プラットフォーム残高** で支払うには、[Data API の Felo](https://openapi.felo.ai/ja/docs/api-reference/openapi/overview.md) を使用してください。このページでは、**Felo Pro クレジット** を使用する既存の `/v2` API を説明します。

Felo APIs は、検索、ドキュメント、プレゼンテーション、Web 抽出、ソーシャル検索、エージェントワークフロー向けのファーストパーティーなワークフローレベル API です。プラットフォームの他の部分と同じ Felo API キーを使用しますが、課金はモデル呼び出しとは別です。

::: tip Felo Pro サブスクリプションクレジット
**Felo APIs は現在、Felo Pro サブスクリプションクレジットを受け付けています。** これはこのセクションのファーストパーティー `/v2` API、つまり Felo Search、PPT Task、Mindmap、LiveDoc、Web Fetch、X Search、YouTube Subtitling、Landing Page、SuperAgent に適用されます。

これは Model API 呼び出し（`/api/v1`）には**適用されません**。Model API 呼び出しには、前払いの Felo API Platform サービスクレジットが必要です。Felo Pro サブスクリプションクレジットは使用できません。
:::

適格性は変更される場合があります。現在の残高と使用状況の正確な情報源は [Console Billing](https://openapi.felo.ai/console/billing) です。

## このセクションの API

| API | エンドポイント | 用途 |
|---|---|---|
| [Felo Search API](https://openapi.felo.ai/ja/docs/api-reference/chat.md) | `POST /v2/chat` | クエリ分析、ソース、引用付きの会話型 Web 検索 |
| [PPT Task API](https://openapi.felo.ai/ja/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | スライドデッキを生成し、タスク状態をポーリングする |
| [Mindmap API](https://openapi.felo.ai/ja/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | プロンプトまたは LiveDoc コンテキストをマインドマップに変換する |
| [LiveDoc API](https://openapi.felo.ai/ja/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | ナレッジベースを作成し、リソースを管理し、コンテキストを取得する |
| [Web Fetch API](https://openapi.felo.ai/ja/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | Web ページを HTML、テキスト、または Markdown として抽出する |
| [X Search API](https://openapi.felo.ai/ja/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | X のユーザー、投稿、タイムライン、返信を検索する |
| [YouTube Subtitling API](https://openapi.felo.ai/ja/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | YouTube の字幕とタイムスタンプを取得する |
| [Landing Page Task API](https://openapi.felo.ai/ja/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | ランディングページを非同期で生成する |
| [SuperAgent API](https://openapi.felo.ai/ja/docs/api-reference/superagent.md) | `POST /v2/conversations` | SSE 上でエージェント会話を実行する |

## 認証と最初の呼び出し

[Console → API Keys](https://openapi.felo.ai/console/api-keys) で 1 つの Felo API キーを作成し、Bearer トークンとして送信します。

```bash
export FELO_API_KEY="YOUR_API_KEY"

curl -sS https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What are the latest AI agent trends?"}'
```

成功したレスポンスには、回答、クエリ分析、引用された Web リソースが含まれます。

## 課金モデル

| 面 | パス | 課金方法 |
|---|---|---|
| Felo APIs | `/v2/*` | Felo Pro クレジット |
| [Data API の Felo](https://openapi.felo.ai/ja/docs/api-reference/openapi/overview.md) | `/api/v1/data/*` | プラットフォーム残高。Pro クレジットではない |
| Model API | `/api/v1/*` | 前払いの Felo API Platform サービスクレジットのみ。Felo Pro は適用されない |
| Data API | `/v1/beta/*` | 各エンドポイントに表示される API カタログの課金基準を使用 |

Felo Pro クレジットと API サービスクレジットは別の残高です。Felo Pro サブスクリプションは API サービスクレジットを自動的に付与せず、API サービスクレジットは Felo Pro サブスクリプションクレジットを追加しません。

## 関連項目

- [Felo Search API](https://openapi.felo.ai/ja/docs/api-reference/chat.md)
- [課金とクレジット](https://openapi.felo.ai/ja/docs/faq/billing-and-credits.md)
- [エラー、制限、再試行](https://openapi.felo.ai/ja/docs/guides/errors-and-limits.md)
- [Console Billing](https://openapi.felo.ai/console/billing)