Protokoly a SDK

Model API mluví třemi drátovými protokoly. Ponechte si stávající SDK a změňte základní URL, API klíč a ID modelu.

Matice endpointů

Základní URL

Oba klienti používají váš Felo API klíč jako API klíč 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",
});

Zvolte protokol

• Použijte Chat Completions, když váš nástroj nebo SDK očekává známé pole messages a choices[0].message.content.
• Použijte Responses, když potřebujete objekt Responses od OpenAI, input, instructions nebo output_text.
• Použijte Messages, když používáte Anthropic SDK nebo nástroj nativní pro Claude.

Než budete předpokládat, že každý protokol funguje, zkontrolujte model. Katalog zpřístupňuje supported_protocols, supported_parameters a recommended_protocol. recommended_protocol je doporučení pro klienta, nikoli omezení; model může stále přijmout jiný protokol.

Streamování

Nastavte stream: true, chcete-li přijímat Server-Sent Events.

• Chat Completions vysílá chatové chunky ve stylu OpenAI.
• Responses vysílá události SSE protokolu Responses a končí dokončeným objektem odpovědi.
• Messages vysílá události streamu zpráv Anthropic.

Čtěte proud událostí přírůstkově a před zavřením připojení obslužte koncovou událost. Přerušené připojení není totéž jako dokončená odpověď.

Volání nástrojů a strukturovaný výstup

Předejte tools v nativním tvaru daného protokolu. Podpora se liší podle modelu, proto před spoléháním na volání nástrojů, režim JSON nebo strukturovaný výstup zkontrolujte supported_parameters v katalogu. Model může pole přijmout a přesto nepodporovanou volbu ignorovat.

Směrování kanálů

Všechny tři endpointy přijímají X-Felo-Channel, když potřebujete připnout poskytovatele. Pravidla hlavičky a příklady najdete v části Kanály a směrování poskytovatelů.

Migrace z oficiálního API

1. Změňte základní URL na odpovídající URL Felo.
2. Nahraďte API klíč hodnotou FELO_API_KEY.
3. Nahraďte název modelu veřejným ID modelu Felo.
4. Ponechte zbytek tvaru požadavku.

Související

• Reference Model API
• Modely a ceny
• Příručka LLM API
• Nastavení AI nástrojů