Protocolli e SDK

La Model API parla tre protocolli di rete. Mantieni il tuo SDK attuale e cambia l'URL di base, la chiave API e l'ID del modello.

Matrice degli endpoint

URL di base

Entrambi i client usano la tua chiave API Felo come chiave API dell'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",
});

Scegliere un protocollo

• Usa Chat Completions quando il tuo strumento o SDK si aspetta il consueto array messages e choices[0].message.content.
• Usa Responses quando ti serve l'oggetto Responses di OpenAI, input, instructions o output_text.
• Usa Messages quando usi un SDK Anthropic o uno strumento nativo Claude.

Controlla il modello prima di dare per scontato che tutti i protocolli funzionino. Il catalogo espone supported_protocols, supported_parameters e un recommended_protocol. recommended_protocol è un consiglio per il client, non una restrizione; un modello può comunque accettare un altro protocollo.

Streaming

Imposta stream: true per ricevere Server-Sent Events.

• Chat Completions emette chunk di chat in stile OpenAI.
• Responses emette eventi SSE di tipo Responses e termina con un oggetto risposta completato.
• Messages emette eventi di stream dei messaggi Anthropic.

Leggi lo stream di eventi in modo incrementale e gestisci l'evento terminale prima di chiudere la connessione. Una connessione interrotta non equivale a una risposta completata.

Chiamate agli strumenti e output strutturato

Passa tools nella forma nativa del protocollo. Il supporto varia da modello a modello, quindi controlla supported_parameters nel catalogo prima di affidarti a chiamate agli strumenti, modalità JSON o output strutturato. Un modello può accettare il campo e ignorare comunque un'opzione non supportata.

Routing dei canali

Tutti e tre gli endpoint accettano X-Felo-Channel quando devi vincolare un provider. Vedi Canali e routing dei provider per le regole dell'header e gli esempi.

Migrare da un'API ufficiale

1. Cambia l'URL di base con l'URL Felo corrispondente.
2. Sostituisci la chiave API con FELO_API_KEY.
3. Sostituisci il nome del modello con l'ID pubblico del modello Felo.
4. Mantieni il resto della struttura della richiesta.

Correlati

• Riferimento Model API
• Modelli e prezzi
• Guida LLM API
• Configurazione degli strumenti IA