Protokoller ve SDK'lar

Model API üç tel protokolü konuşur. Mevcut SDK'nızı koruyun ve temel URL'yi, API anahtarını ve model kimliğini değiştirin.

Endpoint matrisi

Temel URL'ler

Her iki istemci de Felo API anahtarınızı SDK API anahtarı olarak kullanır.

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

Bir protokol seçin

• Aracınız veya SDK'nız tanıdık messages dizisini ve choices[0].message.content yapısını bekliyorsa Chat Completions kullanın.
• OpenAI'nin Responses nesnesine, input, instructions veya output_text alanlarına ihtiyaç duyduğunuzda Responses kullanın.
• Bir Anthropic SDK'sı veya Claude yerel bir araç kullanıyorsanız Messages kullanın.

Her protokolün çalıştığını varsaymadan önce modeli kontrol edin. Katalog supported_protocols, supported_parameters ve bir recommended_protocol sunar. recommended_protocol bir istemci önerisidir, kısıtlama değildir; bir model başka bir protokolü de kabul edebilir.

Akış

Server-Sent Events almak için stream: true ayarlayın.

• Chat Completions, OpenAI tarzı sohbet parçaları yayar.
• Responses, Responses SSE olayları yayar ve tamamlanmış bir yanıt nesnesiyle biter.
• Messages, Anthropic mesaj akışı olayları yayar.

Olay akışını artımlı olarak okuyun ve bağlantıyı kapatmadan önce nihai olayı işleyin. Düşen bir bağlantı, tamamlanmış bir yanıtla aynı şey değildir.

Araç çağrıları ve yapılandırılmış çıktı

tools parametresini protokolün yerel biçiminde geçirin. Destek modele göre değişir, bu nedenle araç çağrılarına, JSON moduna veya yapılandırılmış çıktıya güvenmeden önce katalogdaki supported_parameters alanını kontrol edin. Bir model alanı kabul edip desteklenmeyen bir seçeneği yine de yok sayabilir.

Kanal yönlendirme

Üç endpoint de, bir sağlayıcıyı sabitlemeniz gerektiğinde X-Felo-Channel kabul eder. Başlık kuralları ve örnekler için Kanallar ve Sağlayıcı Yönlendirme bölümüne bakın.

Resmi bir API'den geçiş

1. Temel URL'yi eşleşen Felo URL'siyle değiştirin.
2. API anahtarını FELO_API_KEY ile değiştirin.
3. Model adını genel Felo model kimliğiyle değiştirin.
4. İsteğin geri kalan biçimini koruyun.

İlgili

• Model API referansı
• Modeller ve Fiyatlar
• LLM API kılavuzu
• Yapay Zeka Aracı Kurulumu