Протоколы и SDK

Model API поддерживает три сетевых протокола. Сохраните свой SDK и измените base URL, API key и ID модели.

Матрица endpoint'ов

Base URL

Оба клиента используют ваш Felo API key как API key SDK.

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",
});

Выбор протокола

• Chat Completions — когда инструмент или SDK ожидает привычный массив messages и choices[0].message.content.
• Responses — когда нужен объект Responses, input, instructions или output_text.
• Messages — когда вы используете Anthropic SDK или Claude-нативный инструмент.

Проверьте модель, прежде чем считать, что работают все протоколы. Каталог предоставляет supported_protocols, supported_parameters и recommended_protocol. recommended_protocol — рекомендация для клиента, а не ограничение; модель может принимать и другой протокол.

Streaming

Установите stream: true, чтобы получать Server-Sent Events.

• Chat Completions отправляет chat chunks в стиле OpenAI.
• Responses отправляет Responses SSE events и заканчивается завершённым объектом response.
• Messages отправляет Anthropic message stream events.

Читайте поток событий инкрементально и обрабатывайте терминальное событие до закрытия соединения. Оборванное соединение — это не то же самое, что завершённый ответ.

Вызовы инструментов и structured output

Передавайте tools в нативном формате протокола. Поддержка зависит от модели, поэтому перед использованием tool calls, JSON mode или structured output проверьте supported_parameters в каталоге. Модель может принять поле и всё равно проигнорировать неподдерживаемую опцию.

Маршрутизация по каналам

Все три endpoint'а принимают X-Felo-Channel, когда нужно закрепить провайдера. Правила заголовка и примеры см. в Каналы и маршрутизация провайдеров.

Миграция с официального API

1. Замените base URL на соответствующий URL Felo.
2. Замените API key на FELO_API_KEY.
3. Замените имя модели на публичный ID модели Felo.
4. Остальную часть запроса оставьте без изменений.

Связанные разделы

• Model API reference
• Модели и цены
• Руководство по LLM API
• Настройка AI tools