LLM API

LLM API は Felo API Platform から direct model calling endpoints を提供します。general-purpose language models を呼び出す、OpenAI-compatible / Anthropic-compatible clients を再利用する、agent frameworks を接続する場合に使います。

• POST /api/v1/responses: OpenAI Responses compatible
• POST /api/v1/chat/completions: OpenAI Chat Completions compatible
• POST /api/v1/messages: Anthropic Messages compatible

提供予定：Decisions API

公開 API ではまだ利用できません。利用可能になったことを確認してからサンプルを実行してください。

POST https://openapi.felo.ai/api/v1/decisions

jev-1.13（typesafe/jev-1.13 も可）に状態と型付きの質問を送ります。/api/v1/decisions を使用し、Chat Completions、Messages、Responses には送信しないでください。ストリーミングには対応していません。

リクエスト項目

• model: jev-1.13
• state: 評価するコンテキスト。文字列または JSON 値。
• questions: 名前をキーとする質問。各質問は type、instructions、criteria を含みます。

import os
import requests

response = requests.post(
    "https://openapi.felo.ai/api/v1/decisions",
    headers={"Authorization": f"Bearer {os.environ['FELO_API_KEY']}"},
    json={
        "model": "jev-1.13",
        "state": "Help! My payouts have been failing for 3 days.",
        "questions": {
            "is_urgent": {
                "type": "noul",
                "instructions": "Does this message convey urgency?",
                "criteria": {"true": "Time-sensitive", "false": "No urgency"},
            },
            "department": {
                "type": "choice",
                "instructions": "Which team should handle this?",
                "criteria": {
                    "billing": "Payments, invoicing, refunds",
                    "technical": "Bugs, outages, integrations",
                    "sales": "Pricing, upgrades, new accounts",
                },
            },
            "frustration": {
                "type": "score",
                "instructions": "How frustrated is the customer?",
                "criteria": ["Calm", "Frustrated", "Very angry"],
            },
        },
    },
    timeout=60,
)
response.raise_for_status()
answers = response.json()["answers"]
print(answers["is_urgent"]["noul"])
print(answers["department"]["choice"], answers["department"]["probabilities"])
print(answers["frustration"]["score"])

回答の型

noul：0〜1 の確率。choice：選択肢と確率分布。score：順序付き基準に対する数値スコアと確率分布。

エラーは数値の HTTP ステータス error.code と error.message を返します。answers を読む前に非 2xx レスポンスを処理してください。

使用量と料金

レスポンスには usage.input_tokens、usage.output_tokens が含まれ、usage.cost が含まれる場合もあります。2026-09-22 時点の参考料金は入力 100 万 tokens あたり 0.042 米ドル、出力は 0 米ドルです。出力が無料でも入力は課金されます。料金は変更されるため、公開モデル料金とアカウントの割引を確認してください。

認証

Authorization: Bearer YOUR_API_KEY

Base URL

https://openapi.felo.ai

Anthropic SDK では https://openapi.felo.ai/api を使います。

Model Discovery

共通カタログにはすべてのモデル種別が含まれます。動画モデルと意思決定モデルは専用リストから取得できます。

3 つのエンドポイントは任意のクエリパラメーター provider（例：openrouter）を受け付け、{"object":"list","data":[...]} を返します。各項目には id、object、created、owned_by、model_kind が含まれます。専用リストは、有効なプロバイダーマッピングで上書きされた後の種別で分類します。

削除されておらず、有効かつ表示が許可され、プロバイダー条件に合う現在の料金があるモデルだけを返します。料金 0 も有効です。新規同期モデルは既定で非表示のため、管理者が表示を有効にします。3 つのリストは管理者指定の並び順を共有し、同値の場合はモデル名と ID で並べます。該当なしの場合は HTTP 200 と空の data 配列を返します。ローカルカタログの参照のみで、モデル呼び出しや課金は行いません。

GET /api/v1/models のみ、exclude_video_and_decisions（真偽値、既定値 false）を受け付けます。true にすると、最終的な種別が video_generation または decisions のモデルを除外し、画像モデルは残します。provider と組み合わせられます。省略または false の場合は全種別を返します。不正な真偽値は HTTP 422 を返します。

curl "https://openapi.felo.ai/api/v1/models?exclude_video_and_decisions=true&provider=openrouter" \
  -H "Authorization: Bearer ${FELO_API_KEY}"
curl "https://openapi.felo.ai/api/v1/videos/models?provider=openrouter" \
  -H "Authorization: Bearer ${FELO_API_KEY}"
curl "https://openapi.felo.ai/api/v1/decisions/models?provider=openrouter" \
  -H "Authorization: Bearer ${FELO_API_KEY}"

model_kind に応じて呼び出し先を選びます。chat はモデルが対応する Responses、Chat Completions、Messages、video_generation は POST /api/v1/videos/generations、decisions は POST /api/v1/decisions、image_generation は POST /api/v1/images/generations を使用します。詳細は引き続き GET /api/v1/models/{model_id} で取得します。掲載モデルがすべての対話 API に対応するわけではありません。

モデルと料金

Claude Haiku 5.5 は段階課金です。プロンプトが 100K トークン以下なら上記の標準料金、100K トークンを超えるリクエストはリクエスト全体が入力 $0.50、出力 $2.50、キャッシュ読取 $0.05、キャッシュ書込 $0.0625（各 1M トークン）のロングコンテキスト料金で課金されます。

GPT-5.6 には 3 つのティアがあります。Luna は高速でコスト効率のよい workload 向け、Terra は coding、推論、agentic task のバランス型、Sol は複雑な推論と coding に向いた flagship ティアです。各ティアには -pro model ID（gpt-5.6-luna-pro、gpt-5.6-terra-pro、gpt-5.6-sol-pro）もあり、同じ基盤モデルを pro reasoning mode で使用します。-pro ID の料金、context length、max output は通常 ID と同じです。

DeepSeek V4 Flash は、思考・非思考モード、JSON 出力、ツール呼び出し、Responses API、Anthropic API 互換に対応しています。Felo の Responses、Chat Completions、Messages の各 surface から利用でき、キャッシュ書き込み料金はまだ公開されていません。

Basic Usage

export FELO_API_KEY="YOUR_API_KEY"

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

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

Protocol Reference

レスポンスs

POST https://openapi.felo.ai/api/v1/responses

Chat Completions

POST https://openapi.felo.ai/api/v1/chat/completions

Messages

POST https://openapi.felo.ai/api/v1/messages

Claude Code setup は Claude Code Configuration を参照してください。