Genel Bakış LemonData API, tüm ana yapay zeka geliştirme araçlarıyla doğrudan uyumluluk (drop-in compatibility) için tasarlanmıştır. Bu kılavuz, desteklenen parametreleri ve doğrulanmış entegrasyonları belgelemektedir.
Tüm parametreler doğrulanır ancak üst sağlayıcılara iletilir. Belirli modeller için desteklenmeyen parametreler, maksimum uyumluluk sağlamak amacıyla sessizce yoksayılır.
Uç Nokta Format Kullanım Durumu /v1/chat/completionsOpenAI Chat Evrensel uyumluluk /v1/responsesOpenAI Responses Durumlu (stateful) konuşmalar /v1/messagesAnthropic Messages Claude yerel özellikleri /v1beta/models/:model:generateContentGoogle Gemini Gemini yerel özellikleri
IDE ve CLI Uyumluluğu Doğrulanmış Araçlar Araç Durum Format Notlar Cursor ✅ Tam OpenAI Anthropic araç formatı destekleniyor Claude Code CLI ✅ Tam Anthropic Genişletilmiş düşünme (extended thinking), tool_choice Windsurf ✅ Tam OpenAI Standart OpenAI formatı Aider ✅ Tam OpenAI Tüm modeller destekleniyor Continue.dev ✅ Tam OpenAI/Anthropic Çift format desteği OpenCode ✅ Tam OpenAI Çoklu sağlayıcı desteği Cline/Roo Code ✅ Tam OpenAI OpenRouter formatı üzerinden GitHub Copilot ✅ Tam OpenAI Standart format Codex CLI ✅ Tam OpenAI OpenAI Responses API Gemini CLI ✅ Tam Gemini Yerel Gemini formatı
Yapılandırma Örnekleri Cursor
Claude Code
OpenCode
Aider
Base URL: https://api.lemondata.cc/v1 API Key: sk-your-lemondata-key
Cursor dahili olarak Anthropic tarzı araç formatını kullanır. LemonData her ikisini de destekler:
OpenAI formatı: { type: "function", function: { name, parameters } }
Anthropic formatı: { name, input_schema } (type alanı yok)
export ANTHROPIC_BASE_URL = "https://api.lemondata.cc" export ANTHROPIC_API_KEY = "sk-your-lemondata-key"
export OPENAI_API_KEY = "sk-your-lemondata-key" export LOCAL_ENDPOINT = "https://api.lemondata.cc/v1"
export OPENAI_API_KEY = "sk-your-lemondata-key" export OPENAI_API_BASE = "https://api.lemondata.cc/v1" aider --model gpt-4o
SDK Uyumluluğu Doğrulanmış SDK’lar SDK Dil Durum Notlar OpenAI SDK Python/JS/Go ✅ Tam Tüm parametreler destekleniyor Anthropic SDK Python/JS ✅ Tam Genişletilmiş düşünme, araçlar Vercel AI SDK TypeScript ✅ Tam streamText, generateObjectLangChain Python/JS ✅ Tam ChatOpenAI, bind_toolsLlamaIndex Python ✅ Tam OpenAI uyumlu Dify - ✅ Tam OpenAI formatı
Chat Completions Parametreleri Temel Parametreler Parametre Tür Açıklama modelstring Model tanımlayıcı (gerekli) messagesarray Konuşma mesajları (gerekli) max_tokensinteger Maksimum çıktı token’ları temperaturenumber Örnekleme sıcaklığı (0-2) top_pnumber Çekirdek örnekleme (0-1) streamboolean Akışı (streaming) etkinleştir
{ "tools" : [ { "type" : "function" , "function" : { "name" : "get_weather" , "description" : "Get weather for a location" , "parameters" : { "type" : "object" , "properties" : { "location" : { "type" : "string" } } }, "strict" : true } } ], "tool_choice" : "auto" , "parallel_tool_calls" : true }
Format Örnek Açıklama String "auto", "none", "required"Basit seçim OpenAI Nesnesi { "type": "function", "function": { "name": "fn" } }Belirli bir fonksiyonu zorla Anthropic Nesnesi { "type": "tool", "name": "fn", "disable_parallel_tool_use": true }Anthropic yerel formatı
Gelişmiş Parametreler Parametre Tür Açıklama stream_optionsobject Token sayıları için { include_usage: true } reasoning_effortstring o1/o3 modelleri için "low", "medium", "high" service_tierstring "auto" veya "default"seedinteger Deterministik çıktılar logprobsboolean Log olasılıklarını döndür top_logprobsinteger En yüksek logprob sayısı (0-20) logit_biasobject Token sapma haritası (-100 ile 100 arası) frequency_penaltynumber Tekrarlama cezası (-2 ile 2 arası) presence_penaltynumber Konu cezası (-2 ile 2 arası) stopstring/array Durdurma dizileri ninteger Tamamlama sayısı (1-128) userstring Takip için kullanıcı tanımlayıcı
OpenAI Gelişmiş Özellikleri Parametre Tür Açıklama modalitiesarray Çok modlu (multimodal) için ["text", "audio"] audioobject Ses çıktısı yapılandırması (ses, format) predictionobject Daha hızlı tamamlama için tahmin edilen çıktı metadataobject Takip için anahtar-değer çiftleri storeboolean Daha sonra geri çağırmak için sakla
Sağlayıcıya Özel Seçenekler { "anthropic_options" : { "thinking" : { "type" : "enabled" , "budget_tokens" : 10000 }, "prompt_caching" : true }, "google_options" : { "safety_settings" : [ ... ], "google_search" : true , "code_execution" : true } }
Anthropic Messages Parametreleri Temel Parametreler Parametre Tür Açıklama modelstring Model tanımlayıcı messagesarray Konuşma mesajları max_tokensinteger Maksimum çıktı (128000’e kadar) systemstring/array Sistem istemi (system prompt) streamboolean Akışı etkinleştir
{ "tools" : [ { "name" : "get_weather" , "description" : "Get weather" , "input_schema" : { "type" : "object" , "properties" : { "location" : { "type" : "string" } } } } ], "tool_choice" : { "type" : "auto" , "disable_parallel_tool_use" : false } }
Genişletilmiş Düşünme (Extended Thinking) { "model" : "claude-opus-4-5" , "thinking" : { "type" : "enabled" , "budget_tokens" : 10000 } }
Responses API Parametreleri Temel Parametreler Parametre Tür Açıklama modelstring Model tanımlayıcı inputstring/array Girdi içeriği instructionsstring Sistem talimatları max_output_tokensinteger Maksimum çıktı token’ları previous_response_idstring Konuşmaya devam et
Gelişmiş Parametreler Parametre Tür Açıklama truncation_strategystring "auto" veya "disabled"includearray ["reasoning.encrypted_content"]reasoning_effortstring Akıl yürütme (reasoning) modelleri için service_tierstring Öncelik katmanı
Hem OpenAI hem de Anthropic araç formatlarını destekler:
// OpenAI formatı { "type" : "function" , "name" : "fn" , "parameters" : { ... } } // Anthropic formatı (Cursor uyumluluğu) { "name" : "fn" , "input_schema" : { ... } }
Gemini API Parametreleri Temel Parametreler Parametre Tür Açıklama contentsarray Konuşma içeriği systemInstructionobject Sistem istemi generationConfigobject Oluşturma ayarları
{ "tools" : [{ "functionDeclarations" : [{ "name" : "search" , "description" : "Search the web" , "parameters" : { ... } }], "codeExecution" : {}, "googleSearch" : {} }], "toolConfig" : { "functionCallingConfig" : { "mode" : "AUTO" } } }
Güvenlik Ayarları (Safety Settings) { "safetySettings" : [ { "category" : "HARM_CATEGORY_HARASSMENT" , "threshold" : "BLOCK_MEDIUM_AND_ABOVE" } ] }
Ek Parametreler Parametre Tür Açıklama cachedContentstring Önbelleğe alınmış içerik referansı responseMimeTypestring "text/plain" veya "application/json"responseSchemaobject Yapılandırılmış çıktı için JSON şeması
Akış (Streaming) Tüm uç noktalar Server-Sent Events (SSE) akışını destekler:
# Chat Completions curl https://api.lemondata.cc/v1/chat/completions \ -H "Authorization: Bearer sk-xxx" \ -d '{"model": "gpt-4o", "messages": [...], "stream": true}' # Kullanım takibi ile -d '{"...", "stream_options": {"include_usage": true}}'
Hata Yönetimi LemonData, OpenAI uyumlu hata yanıtları döndürür:
{ "error" : { "message" : "Invalid API key" , "type" : "invalid_api_key" , "code" : "invalid_api_key" } }
Detaylar için Hata Yönetimi Kılavuzu sayfasına bakın.
En İyi Uygulamalar
Bilinmeyen parametreler için passthrough kullanın
Tüm şemalar .passthrough() kullanır - bilinmeyen parametreler üst sağlayıcılara iletilir.
Doğru faturalandırma için stream_options tercih edin
Akış yanıtlarında doğru token sayıları için stream_options.include_usage özelliğini etkinleştirin.
Uygun tool_choice formatını kullanın
SDK’nızın beklediği formatla eşleştirin. LemonData hem OpenAI hem de Anthropic formatlarını kabul eder.
