Protokol dan SDK

Model API mendukung tiga protokol kabel. Pertahankan SDK yang sudah Anda gunakan dan ubah Base URL, kunci API, serta ID model.

Matriks Endpoint

Base URL

Kedua 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",
});

Memilih Protokol

• Gunakan Chat Completions saat alat atau SDK Anda mengharapkan array messages yang sudah dikenal dan choices[0].message.content.
• Gunakan Responses saat Anda memerlukan objek Responses milik OpenAI, input, instructions, atau output_text.
• Gunakan Messages saat Anda menggunakan SDK Anthropic atau alat native Claude.

Periksa model sebelum mengasumsikan setiap protokol berfungsi. Katalog mengekspos supported_protocols, supported_parameters, dan recommended_protocol. recommended_protocol adalah rekomendasi klien, bukan pembatasan; model mungkin tetap menerima protokol lain.

Streaming

Setel stream: true untuk menerima Server-Sent Events.

• Chat Completions memancarkan chunk chat bergaya OpenAI.
• Responses memancarkan event SSE Responses dan diakhiri dengan objek respons yang telah selesai.
• Messages memancarkan event stream pesan Anthropic.

Baca aliran event secara inkremental dan tangani event terminal sebelum menutup koneksi. Koneksi yang terputus tidak sama dengan respons yang selesai.

Panggilan Alat dan Output Terstruktur

Berikan tools dalam bentuk native protokol. Dukungan bervariasi menurut model, jadi periksa supported_parameters di katalog sebelum mengandalkan panggilan alat, mode JSON, atau output terstruktur. Model dapat menerima field tersebut tetapi tetap mengabaikan opsi yang tidak didukung.

Routing Kanal

Ketiga endpoint menerima X-Felo-Channel saat Anda perlu menyematkan penyedia. Lihat Kanal dan Routing Penyedia untuk aturan header dan contoh.

Migrasi dari API Resmi

1. Ubah Base URL ke URL Felo yang sesuai.
2. Ganti kunci API dengan FELO_API_KEY.
3. Ganti nama model dengan ID model Felo publik.
4. Pertahankan sisa bentuk permintaan.

Terkait

• Referensi Model API
• Model dan Harga
• Panduan LLM API
• Penyiapan Alat AI