Giao thức và SDK

Model API hỗ trợ ba giao thức truyền tải. Hãy giữ SDK hiện có và chỉ thay base URL, khóa API và model ID.

Ma trận endpoint

Base URL

Cả hai máy khách đều dùng khóa API Felo của bạn làm khóa API của 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",
});

Chọn giao thức

• Dùng Chat Completions khi công cụ hoặc SDK của bạn mong đợi mảng messages quen thuộc và choices[0].message.content.
• Dùng Responses khi bạn cần đối tượng Responses của OpenAI, input, instructions hoặc output_text.
• Dùng Messages khi bạn đang dùng Anthropic SDK hoặc một công cụ gốc Claude.

Hãy kiểm tra mô hình trước khi giả định mọi giao thức đều hoạt động. Danh mục công bố supported_protocols, supported_parameters và recommended_protocol. recommended_protocol là khuyến nghị cho máy khách, không phải giới hạn; một mô hình vẫn có thể chấp nhận giao thức khác.

Truyền trực tiếp

Đặt stream: true để nhận Server-Sent Events.

• Chat Completions phát ra các chunk chat kiểu OpenAI.
• Responses phát ra các sự kiện SSE của Responses và kết thúc bằng một đối tượng phản hồi đã hoàn tất.
• Messages phát ra các sự kiện luồng message của Anthropic.

Hãy đọc luồng sự kiện tăng dần và xử lý sự kiện kết thúc trước khi đóng kết nối. Kết nối bị ngắt không giống với một phản hồi đã hoàn tất.

Gọi công cụ và đầu ra có cấu trúc

Truyền tools theo hình dạng gốc của giao thức. Mức hỗ trợ thay đổi theo mô hình, nên hãy kiểm tra supported_parameters trong danh mục trước khi dựa vào gọi công cụ, chế độ JSON hoặc đầu ra có cấu trúc. Một mô hình có thể chấp nhận trường này mà vẫn bỏ qua một tùy chọn không được hỗ trợ.

Định tuyến kênh

Cả ba endpoint đều chấp nhận X-Felo-Channel khi bạn cần ghim một nhà cung cấp. Xem Kênh và định tuyến nhà cung cấp để biết quy tắc header và ví dụ.

Di chuyển từ API chính thức

1. Đổi base URL sang URL Felo tương ứng.
2. Thay khóa API bằng FELO_API_KEY.
3. Thay tên mô hình bằng model ID công khai của Felo.
4. Giữ nguyên phần còn lại của cấu trúc yêu cầu.

Liên quan

• Tham chiếu Model API
• Mô hình và giá
• Hướng dẫn LLM API
• Thiết lập công cụ AI