Протоколи та SDK

Model API підтримує три мережеві протоколи. Залиште свій наявний SDK і змініть базову URL-адресу, API-ключ та ID моделі.

Матриця endpoint

Базові URL-адреси

Обидва клієнти використовують ваш API-ключ Felo як API-ключ 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 від OpenAI, input, instructions або output_text.
• Використовуйте Messages, коли працюєте з Anthropic SDK або інструментом із рідним Claude.

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

Потокова передача

Установіть stream: true, щоб отримувати Server-Sent Events.

• Chat Completions надсилає фрагменти чату у стилі OpenAI.
• Responses надсилає події SSE Responses і завершується об'єктом завершеної відповіді.
• Messages надсилає події потоку повідомлень Anthropic.

Читайте потік подій поступово та обробіть термінальну подію перед закриттям з'єднання. Розірване з'єднання не означає завершену відповідь.

Виклики інструментів і структурований вивід

Передавайте tools у рідній формі протоколу. Підтримка залежить від моделі, тому перед тим як покладатися на виклики інструментів, режим JSON або структурований вивід, перевірте supported_parameters у каталозі. Модель може приймати поле й усе одно ігнорувати непідтримуваний параметр.

Маршрутизація каналів

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

Перехід з офіційного API

1. Змініть базову URL-адресу на відповідну URL-адресу Felo.
2. Замініть API-ключ на FELO_API_KEY.
3. Замініть назву моделі на публічний ID моделі Felo.
4. Залиште решту структури запиту без змін.

Пов'язані розділи

• Довідник Model API
• Моделі та ціни
• Посібник з LLM API
• Налаштування інструментів ШІ