Skip to main content
API リファレンスドキュメントは現在英語のみで利用可能です。このページを別の言語で表示している場合は、英語版に切り替えてください。左側のサイドバーに完全なAPIエンドポイントリストが表示されます。
FIM One は、AI 智能体、会話、ナレッジベースなどへのプログラマティックアクセスのための REST API を提供します。

ベースURL

認証

すべてのAPI リクエストは、APIキーまたはJWTトークンを使用した認証が必要です。

APIキーの使用

AuthorizationヘッダーにAPIキーを含めます:

JWT トークンの使用

SSE ストリーミングエンドポイント(/api/react/api/dag)の場合、リクエストボディでトークンを渡すことができます:
詳細なセットアップ手順については、認証を参照してください。

レスポンス形式

成功レスポンス

すべての成功したAPIレスポンスは、以下の構造に従います:

エラーレスポンス

エラーレスポンスにはエラーコードと人間が読める形のメッセージが含まれます:

ページネーション付きレスポンス

リストエンドポイントはページネーション付きの結果を返します:

ストリーミング (Server-Sent Events)

チャットエンドポイント (POST /api/reactPOST /api/dag) はリアルタイムストリーミング用の Server-Sent Events を返します。各イベントには、そのコンテンツを示す type フィールドがあります:

SSE ストリーム例

カーソルベースの再開

すべてのSSEイベントには、会話にスコープされた単調なcursor整数が含まれます。クライアントは最も高いカーソルを追跡する必要があります。接続がターン中に切断された場合(ネットワークエラー、プロキシタイムアウト、サーバー再起動)、クライアントはエージェントを再実行せずに再度サブスクライブできます:
レスポンスはSSEストリームで、cursor > 42のキャッシュされたイベントを再生し、ターミナルevent: resume_doneフレームで終了します。cursor: -1を渡して、最初からの完全な再生をリクエストします。 エラーレスポンス:
  • 404 conversation_not_found — 会話IDが無効であるか、認証されたユーザーが所有していない
  • 404 no_recent_assistant_message — 会話に再開するための永続化されたアシスタントターンがない(例:ユーザーメッセージがない新しい会話)
  • 400 invalid_cursor — カーソルが非負の整数または-1ではない
リファレンスフロントエンド実装(プレイグラウンドのuseSseResumeフック)は、ネットワーク切断を指数バックオフ(300ms → 1s → 3s、最大3回の試行)で自動再試行し、ユーザーが開始した中止とネットワークエラーを区別して、意図しない再接続を回避します。完全なパターンについては、playground-page.tsx統合を参照してください。
再開はステートレスです — アシスタントメッセージの保存されたsse_events配列から再生します。エージェントのターンがアシスタントメッセージが永続化される前に中断された場合(例:doneの前のクラッシュ)、ぶら下がったtool_useブロックは次のターンでDbMemory._repair_dangling_tool_callsによって自動修復されます。合成tool_result行はmetadata_.synthetic=trueおよびmetadata_.reason="interrupted"で永続化され、監査用に使用されます。

レート制限

キーごとのレート制限は将来のリリースで予定されています。現在、キーごとのリクエスト制限は強制されていませんが、APIを責任を持って使用してください。

ページネーション

リストエンドポイントはクエリパラメータを使用したページネーションをサポートしています:
パラメータ:
  • page (デフォルト: 1) — ページ番号、1から始まります
  • size (デフォルト: 20) — ページあたりのアイテム数、最大 100

タイムスタンプ

すべてのタイムスタンプはUTCタイムゾーン付きのISO 8601形式です:

エラーコード

一般的なエラーコードとその意味:

API プレイグラウンド

各エンドポイントページには、以下のことができるインタラクティブな API プレイグラウンドが含まれています:
  • ブラウザから直接リクエストをテストする
  • 実際のレスポンスを表示する
  • 複数の言語でリクエストコードをコピーする
  • API キーで認証する
API プレイグラウンドはブラウザからリクエストを実行するため、API キーに適切な CORS パーミッションがあることを確認してください (通常、同一オリジンのリクエストではデフォルトで有効になっています)。

SDK の利用可能性

FIM One API は完全に REST ベースですが、一般的なプログラミング言語で SDK が利用可能です (またはまもなく利用可能になります):
  • Python: 近日公開予定
  • JavaScript/TypeScript: 近日公開予定
  • Go: 近日公開予定

バージョニング

現在のAPIバージョンは v0.8.0 です。バージョンはURLパスに含まれていません。破壊的な変更はメジャーバージョンのバンプと移行期間を通じて通知されます。

サポート

API の問題または質問については:
  • ドキュメント: 各エンドポイントの詳細ガイドを参照してください
  • GitHub Issues: バグを報告してください https://github.com/fim-ai/fim-one/issues
  • Discord コミュニティ: コミュニティに参加して議論してください