Felo API Platform

LLM API

Вызывайте model endpoints Felo через OpenAI-compatible и Anthropic-compatible протоколы.

GET/api/v1/models

Аутентификация

Bearer API key or X-API-Key

Content type

application/json

Ограничения

Model service limits may apply. Retry with backoff on 429 or 503.

Models Claude Code

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: вход — 0.042 USD за миллион tokens, выход — 0 USD. Бесплатный выход не означает бесплатный вход. Тарифы могут меняться; учитывайте опубликованную цену модели и скидки аккаунта.

Аутентификация

Authorization: Bearer YOUR_API_KEY

Base URL

https://openapi.felo.ai

Anthropic SDK では https://openapi.felo.ai/api をиспользуйте。

Model Discovery

Общий каталог сохраняет все типы моделей. Для видео и принятия решений доступны отдельные списки:

Эндпоинт	Типы моделей
`GET /api/v1/models`	Все типы (без изменений)
`GET /api/v1/videos/models`	Генерация видео (`video_generation`)
`GET /api/v1/decisions/models`	Принятие решений, включая Jev (`decisions`)

Все три эндпоинта поддерживают необязательный параметр provider (например, openrouter) и возвращают {"object":"list","data":[...]}. Каждый элемент содержит id, object, created, owned_by и model_kind. Отдельные списки используют итоговый тип после применения переопределений активного провайдера.

Возвращаются только неудалённые, включённые и разрешённые к показу модели с текущей ценой, соответствующей условиям провайдера; нулевая цена допустима. Новые синхронизированные модели скрыты, пока администратор не включит показ. Все списки используют заданный администратором порядок, затем имя и 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.

Модели и цены

Model ID	Context	Max output	Input / 1M tokens	Output / 1M tokens	Cache read / 1M tokens	Cache write / 1M tokens
`claude-haiku-4-5`	200K	64K	`$1.00`	`$5.00`	`$0.10`	`$1.25`
`claude-sonnet-4-6`	1M	128K	`$3.00`	`$15.00`	`$0.30`	`$3.75`
`claude-opus-4-8`	1M	128K	`$5.00`	`$25.00`	`$0.50`	`$6.25`
`claude-sonnet-5`	1M	128K	`$2.00`	`$10.00`	`$0.20`	`$2.50`
`claude-haiku-5-5`	1M	128K	`$0.10`	`$0.50`	`$0.01`	`$0.0125`
`gpt-5.5`	1.05M	128K	`$5.00`	`$30.00`	`$0.50`	-
`gpt-5.5-pro`	1.05M	128K	`$30.00`	`$180.00`	-	-
`gpt-5.6-luna`	1.05M	128K	`$1.00`	`$6.00`	`$0.10`	`$1.25`
`gpt-5.6-terra`	1.05M	128K	`$2.50`	`$15.00`	`$0.25`	`$3.125`
`gpt-5.6-sol`	1.05M	128K	`$5.00`	`$30.00`	`$0.50`	`$6.25`
`grok-4.5`	500K	-	`$2.00`	`$6.00`	`$0.50`	-
`deepseek-v4-flash`	1M	384K	`$0.09`	`$0.18`	`$0.018`	-

Claude Haiku 5.5 использует ступенчатую тарификацию: prompt до 100K токенов оплачивается по стандартным тарифам выше, а запросы с prompt более 100K токенов тарифицируются по ценам длинного контекста — $0.50 ввод, $2.50 вывод, $0.05 чтение кэша и $0.0625 запись кэша за 1 млн токенов — для всего запроса.

GPT-5.6 доступен в трех уровнях: Luna для быстрых и cost-efficient workloads, Terra для сбалансированных coding, reasoning и agentic tasks, Sol для flagship complex reasoning и coding. Каждый уровень также имеет -pro model ID (gpt-5.6-luna-pro, gpt-5.6-terra-pro, gpt-5.6-sol-pro), который использует ту же базовую модель в pro reasoning mode. Цена, context length и max output для -pro ID не меняются.

DeepSeek V4 Flash поддерживает режимы с рассуждениями и без них, JSON-вывод, вызовы инструментов, Responses API и совместимость с Anthropic API. Модель доступна через поверхности Felo Responses, Chat Completions и Messages; цена записи в кеш пока не опубликована.

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 をсм.。