Protocolos e SDKs

A Model API fala três protocolos de rede. Mantenha seu SDK atual e altere a URL base, a chave de API e o ID do modelo.

Matriz de endpoints

URLs base

Os dois clientes usam sua chave de API Felo como a chave de API do 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",
});

Escolha um protocolo

• Use Chat Completions quando sua ferramenta ou SDK espera o array messages e choices[0].message.content familiares.
• Use Responses quando precisar do objeto Responses da OpenAI, de input, instructions ou output_text.
• Use Messages quando estiver usando um SDK da Anthropic ou uma ferramenta nativa do Claude.

Verifique o modelo antes de presumir que todo protocolo funciona. O catálogo expõe supported_protocols, supported_parameters e um recommended_protocol. recommended_protocol é uma recomendação para o cliente, não uma restrição; um modelo ainda pode aceitar outro protocolo.

Streaming

Defina stream: true para receber Server-Sent Events.

• Chat Completions emite chunks de chat no estilo OpenAI.
• Responses emite eventos SSE de Responses e termina com um objeto de resposta concluída.
• Messages emite eventos de stream de mensagem da Anthropic.

Leia o stream de eventos de forma incremental e trate o evento terminal antes de fechar a conexão. Uma conexão interrompida não é o mesmo que uma resposta concluída.

Chamadas de ferramentas e saída estruturada

Passe tools no formato nativo do protocolo. O suporte varia por modelo, então verifique supported_parameters no catálogo antes de depender de chamadas de ferramentas, do modo JSON ou de saída estruturada. Um modelo pode aceitar o campo e ainda ignorar uma opção sem suporte.

Roteamento de canais

Os três endpoints aceitam X-Felo-Channel quando você precisa fixar um provedor. Consulte Canais e roteamento de provedores para ver as regras do cabeçalho e exemplos.

Migre de uma API oficial

1. Altere a URL base para a URL Felo correspondente.
2. Substitua a chave de API por FELO_API_KEY.
3. Substitua o nome do modelo pelo ID de modelo público da Felo.
4. Mantenha o restante do formato da requisição.

Relacionados

• Referência da Model API
• Modelos e preços
• Guia da LLM API
• Configuração de ferramentas de IA