Protocolos y SDK

La Model API habla tres protocolos de red. Conserva tu SDK actual y cambia la URL base, la clave de API y el ID de modelo.

Matriz de endpoints

URL base

Ambos clientes usan tu clave de API de Felo como clave de API del 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",
});

Elegir un protocolo

• Usa Chat Completions cuando tu herramienta o SDK espere el conocido array messages y choices[0].message.content.
• Usa Responses cuando necesites el objeto Responses de OpenAI, input, instructions u output_text.
• Usa Messages cuando uses un SDK de Anthropic o una herramienta nativa de Claude.

Comprueba el modelo antes de dar por hecho que todos los protocolos funcionan. El catálogo expone supported_protocols, supported_parameters y un recommended_protocol. recommended_protocol es una recomendación para el cliente, no una restricción; un modelo puede seguir aceptando otro protocolo.

Streaming

Define stream: true para recibir eventos enviados por el servidor.

• Chat Completions emite fragmentos de chat al estilo de OpenAI.
• Responses emite eventos SSE de Responses y termina con un objeto de respuesta completado.
• Messages emite eventos de flujo de mensajes de Anthropic.

Lee el flujo de eventos de forma incremental y gestiona el evento terminal antes de cerrar la conexión. Una conexión interrumpida no equivale a una respuesta completada.

Llamadas a herramientas y salida estructurada

Pasa tools con la forma nativa del protocolo. La compatibilidad varía según el modelo, así que comprueba supported_parameters en el catálogo antes de depender de llamadas a herramientas, del modo JSON o de la salida estructurada. Un modelo puede aceptar el campo y aun así ignorar una opción no admitida.

Enrutamiento por canal

Los tres endpoints aceptan X-Felo-Channel cuando necesitas fijar un proveedor. Consulta Canales y enrutamiento de proveedores para ver las reglas del encabezado y ejemplos.

Migrar desde una API oficial

1. Cambia la URL base por la URL de Felo correspondiente.
2. Sustituye la clave de API por FELO_API_KEY.
3. Sustituye el nombre del modelo por el ID de modelo público de Felo.
4. Conserva el resto de la forma de la solicitud.

Relacionado

• Referencia de la Model API
• Modelos y precios
• Guía de la LLM API
• Configuración de herramientas de IA