Protokoły i SDK

Model API obsługuje trzy protokoły transmisji. Zachowaj istniejący SDK i zmień bazowy adres URL, klucz API oraz identyfikator modelu.

Macierz endpointów

Bazowe adresy URL

Oba klienty używają Twojego klucza API Felo jako klucza 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",
});

Wybór protokołu

• Użyj Chat Completions, gdy Twoje narzędzie lub SDK oczekuje znanej tablicy messages i choices[0].message.content.
• Użyj Responses, gdy potrzebujesz obiektu Responses OpenAI, pól input, instructions lub output_text.
• Użyj Messages, gdy korzystasz z Anthropic SDK lub narzędzia natywnego dla Claude.

Sprawdź model, zanim założysz, że każdy protokół działa. Katalog udostępnia supported_protocols, supported_parameters i recommended_protocol. recommended_protocol to rekomendacja dla klienta, a nie ograniczenie; model może nadal akceptować inny protokół.

Przesyłanie strumieniowe

Ustaw stream: true, aby otrzymywać zdarzenia Server-Sent Events.

• Chat Completions emituje fragmenty czatu w stylu OpenAI.
• Responses emituje zdarzenia SSE Responses i kończy się ukończonym obiektem odpowiedzi.
• Messages emituje zdarzenia strumienia komunikatów Anthropic.

Odczytuj strumień zdarzeń przyrostowo i obsłuż zdarzenie terminalne przed zamknięciem połączenia. Przerwane połączenie nie jest tym samym co ukończona odpowiedź.

Wywołania narzędzi i dane wyjściowe o strukturze

Przekazuj tools w natywnym kształcie protokołu. Obsługa różni się w zależności od modelu, więc przed poleganiem na wywołaniach narzędzi, trybie JSON lub danych wyjściowych o strukturze sprawdź supported_parameters w katalogu. Model może przyjąć pole i nadal zignorować nieobsługiwaną opcję.

Routing kanałów

Wszystkie trzy endpointy akceptują X-Felo-Channel, gdy potrzebujesz przypiąć dostawcę. Zasady nagłówka i przykłady znajdziesz w Kanałach i routingu dostawców.

Migracja z oficjalnego API

1. Zmień bazowy adres URL na pasujący adres URL Felo.
2. Zastąp klucz API kluczem FELO_API_KEY.
3. Zastąp nazwę modelu publicznym identyfikatorem modelu Felo.
4. Zachowaj resztę kształtu żądania.

Powiązane

• Dokumentacja Model API
• Modele i ceny
• Przewodnik API LLM
• Konfiguracja narzędzi AI