Protokol dan SDK

Model API bertutur dalam tiga protokol wayar. Kekalkan SDK sedia ada anda dan tukar URL asas, kunci API, dan ID model.

Matriks endpoint

URL asas

Kedua-dua klien menggunakan kunci API Felo anda sebagai kunci API 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",
});

Pilih protokol

• Gunakan Chat Completions apabila alat atau SDK anda menjangkakan tatasusunan messages yang biasa dan choices[0].message.content.
• Gunakan Responses apabila anda memerlukan objek Responses OpenAI, input, instructions, atau output_text.
• Gunakan Messages apabila anda menggunakan SDK Anthropic atau alat asli Claude.

Semak model sebelum menganggap setiap protokol berfungsi. Katalog mendedahkan supported_protocols, supported_parameters, dan recommended_protocol. recommended_protocol ialah cadangan klien, bukan sekatan; model mungkin masih menerima protokol lain.

Penstriman

Tetapkan stream: true untuk menerima Server-Sent Events.

• Chat Completions mengeluarkan chunk chat gaya OpenAI.
• Responses mengeluarkan peristiwa SSE Responses dan berakhir dengan objek respons yang selesai.
• Messages mengeluarkan peristiwa aliran mesej Anthropic.

Baca aliran peristiwa secara berperingkat dan kendalikan peristiwa terminal sebelum menutup sambungan. Sambungan yang terputus tidak sama dengan respons yang selesai.

Panggilan alat dan output berstruktur

Hantar tools dalam bentuk asli protokol. Sokongan berbeza mengikut model, jadi semak supported_parameters dalam katalog sebelum bergantung pada panggilan alat, mod JSON, atau output berstruktur. Sesuatu model boleh menerima medan itu tetapi masih mengabaikan pilihan yang tidak disokong.

Penghalaan saluran

Ketiga-tiga endpoint menerima X-Felo-Channel apabila anda perlu menetapkan penyedia. Lihat Saluran dan Penghalaan Penyedia untuk peraturan pengepala dan contoh.

Berhijrah daripada API rasmi

1. Tukar URL asas kepada URL Felo yang sepadan.
2. Gantikan kunci API dengan FELO_API_KEY.
3. Gantikan nama model dengan ID model Felo awam.
4. Kekalkan bentuk permintaan yang lain.

Berkaitan

• Rujukan Model API
• Model dan Harga
• Panduan LLM API
• Persediaan Alat AI