Protokolle und SDKs

Die Model API spricht drei Wire-Protokolle. Behalten Sie Ihr vorhandenes SDK und ändern Sie Base-URL, API-Schlüssel und Modell-ID.

Endpoint-Matrix

Base-URLs

Beide Clients verwenden Ihren Felo API-Schlüssel als SDK-API-Schlüssel.

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

Protokoll wählen

• Verwenden Sie Chat Completions, wenn Ihr Tool oder SDK das vertraute messages-Array und choices[0].message.content erwartet.
• Verwenden Sie Responses, wenn Sie das Responses-Objekt von OpenAI, input, instructions oder output_text benötigen.
• Verwenden Sie Messages, wenn Sie ein Anthropic SDK oder ein Claude-natives Tool verwenden.

Prüfen Sie das Modell, bevor Sie davon ausgehen, dass jedes Protokoll funktioniert. Der Katalog stellt supported_protocols, supported_parameters und ein recommended_protocol bereit. recommended_protocol ist eine Client-Empfehlung, keine Einschränkung; ein Modell kann trotzdem ein anderes Protokoll akzeptieren.

Streaming

Setzen Sie stream: true, um Server-Sent Events zu erhalten.

• Chat Completions sendet Chat-Chunks im OpenAI-Stil.
• Responses sendet SSE-Ereignisse im Responses-Stil und endet mit einem abgeschlossenen Antwortobjekt.
• Messages sendet Ereignisse des Anthropic-Nachrichtenstreams.

Lesen Sie den Ereignisstream schrittweise und behandeln Sie das Abschlussereignis, bevor Sie die Verbindung schließen. Eine abgebrochene Verbindung ist nicht dasselbe wie eine abgeschlossene Antwort.

Tool-Aufrufe und strukturierte Ausgabe

Übergeben Sie tools in der nativen Form des Protokolls. Die Unterstützung variiert je nach Modell; prüfen Sie daher supported_parameters im Katalog, bevor Sie sich auf Tool-Aufrufe, den JSON-Modus oder strukturierte Ausgabe verlassen. Ein Modell kann das Feld akzeptieren und eine nicht unterstützte Option trotzdem ignorieren.

Kanal-Routing

Alle drei Endpoints akzeptieren X-Felo-Channel, wenn Sie einen Anbieter binden möchten. Die Header-Regeln und Beispiele finden Sie unter Kanäle und Anbieter-Routing.

Von einer offiziellen API migrieren

1. Ändern Sie die Base-URL in die passende Felo-URL.
2. Ersetzen Sie den API-Schlüssel durch FELO_API_KEY.
3. Ersetzen Sie den Modellnamen durch die öffentliche Felo-Modell-ID.
4. Behalten Sie die übrige Form der Anfrage bei.

Verwandte Themen

• Model API-Referenz
• Modelle und Preise
• LLM API-Anleitung
• Einrichtung von KI-Tools