プロトコルと SDK

Model API は 3 つの通信プロトコルに対応しています。既存の SDK をそのまま使い、base URL、API key、モデル ID だけを変更してください。

Endpoint 一覧

Base URL

どちらのクライアントも、SDK の API key として Felo API key を使います。

import OpenAI from "openai";
import Anthropic from "@anthropic-ai/sdk";

const openai = new OpenAI({
  apiKey: process.env.FELO_API_KEY,
  baseURL: "https://openapi.felo.ai/api/v1",
});

const anthropic = new Anthropic({
  apiKey: process.env.FELO_API_KEY,
  baseURL: "https://openapi.felo.ai/api",
});

プロトコルを選ぶ

• ツールや SDK がおなじみの messages 配列と choices[0].message.content を前提とする場合は Chat Completions。
• OpenAI の Responses オブジェクト、input、instructions、output_text が必要な場合は Responses。
• Anthropic SDK や Claude ネイティブツールを使う場合は Messages。

すべてのプロトコルが使えると決めつける前にモデルを確認してください。カタログには supported_protocols、supported_parameters、recommended_protocol が公開されています。recommended_protocol はクライアント向けの推奨であり制限ではありません。モデルが別のプロトコルを受け付けることもあります。

ストリーミング

stream: true を設定すると Server-Sent Events を受け取ります。

• Chat Completions は OpenAI 形式の chat chunk を送出します。
• Responses は Responses SSE event を送出し、完了した response オブジェクトで終わります。
• Messages は Anthropic message stream event を送出します。

イベントストリームを逐次読み取り、接続を閉じる前に終端イベントを処理してください。接続の切断は完了したレスポンスとは異なります。

ツール呼び出しと構造化出力

tools はプロトコル本来の形式で渡します。対応状況はモデルによって異なるため、ツール呼び出し、JSON モード、構造化出力に依存する前にカタログの supported_parameters を確認してください。フィールドを受け付けても、未対応のオプションを無視するモデルもあります。

チャネルルーティング

3 つの endpoint はいずれも、プロバイダーを固定するための X-Felo-Channel を受け付けます。ヘッダーのルールと例はチャネルとプロバイダールーティングを参照してください。

公式 API からの移行

1. base URL を対応する Felo の URL に変更します。
2. API key を FELO_API_KEY に置き換えます。
3. モデル名を公開されている Felo モデル ID に置き換えます。
4. リクエストの残りの形はそのままにします。

関連

• Model API reference
• モデルと料金
• LLM API ガイド
• AI ツール設定