Genel Bakış LemonData, yaygın kodlama araçlarının, SDK’ların ve çerçevelerin minimum bağlantı kodu ile entegre olabilmesi için birden fazla API formatı sunar.
Bu sayfa kasıtlı olarak bir pazarlama matrisinden daha dar kapsamlıdır:
Supported belgelenmiş somut bir kurulum yolunu ve LemonData’nın bu yolun beklediği protokol şekline uygunluğu sunduğu anlamına gelir.Strong native path depo ayrıca o protokol ailesi için doğrudan adaptör veya istek-formatı kanıtına sahip olduğunu gösterir.Best-effort entegrasyonun çalışabileceği, ancak yukarı akış istemcisinin bu özel gateway iş akışını istikrarlı bir sözleşme olarak ele almadığı anlamına gelir.
Desteklenmeyen alanlar tutarlı şekilde ele alınmaz. Uyumluluk yollarında bazı alanlar yoksayılır veya normalize edilir. /v1/responses rotasında, istenen davranışı garanti edemediğinde desteklenmeyen alanlar açık 400 veya 503 hataları döndürebilir.
Endpoint Format Kullanım Durumu /v1/chat/completionsOpenAI Chat Evrensel uyumluluk /v1/responsesOpenAI Responses Durum bilgisi içeren konuşmalar /v1/messagesAnthropic Messages Claude yerel özellikleri /v1beta/models/:model:generateContentGoogle Gemini Gemini yerel özellikleri
IDE & CLI Uyumluluğu Belgelendirilmiş Araç Yolları Tool Destek Seviyesi Format Notlar Cursor Supported with limits OpenAI-compatible BYOK standart sohbet/düzenleyici akışları için çalışır; Cursor tarafından yönetilen Tab Completion gibi özelliklerin yerine geçmez Claude Code CLI Strong native path Anthropic Düşünme ve tool_choice için adaptör kapsamı ile yerel /v1/messages rotası Codex CLI Supported with model/path limits OpenAI Responses Codex-özel iş akışları için gelişmiş bir yol olarak /v1/responses’i ele alın; bazı yalnızca Responses alanları her model ve yönlendirilmiş yol için garanti edilmez Gemini CLI Best-effort / experimental Gemini Özel LemonData base URL akışı istikrarlı bir yukarı akış sözleşmesi değildir OpenCode Supported OpenAI-compatible Varsayılan olarak OpenAI-compatible bir sağlayıcı kullanın; yalnızca açıkça ihtiyaç duyduğunuzda Responses-temelli bir sağlayıcıya geçin
Diğer OpenAI-uyumlu düzenleyiciler ve ajan araçlar genellikle aynı temel URL deseni ile çalışır, ancak bu depo şu anda Windsurf, Aider, Continue.dev, Cline/Roo Code, GitHub Copilot ve benzeri istemciler için araç-spesifik regresyon kapsamını sürdürmemektedir.
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 iki formatı da 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_BASE_URL = "https://api.lemondata.cc/v1" aider --model gpt-5.4
SDK Uyumluluğu Belgelendirilmiş SDK & Çerçeve Yolları SDK / Framework Dil Destek Seviyesi Notlar OpenAI SDK Python/JS/Go Supported core path Chat Completions ve Embeddings varsayılan belgelenmiş yoldur; bazı yalnızca Responses alanları her model ve yönlendirilmiş yol için garanti edilmez Anthropic SDK Python/JS Strong native path Araçlar, düşünme ve prompt önbellekleme için doğrudan kanıtla yerel Messages rotası Vercel AI SDK TypeScript Recommended integration pattern @ai-sdk/openai-compatible tercih edin; yalnızca açıkça Responses-native davranışı istediğinizde @ai-sdk/openai kullanınLangChain Python/JS Supported standard surfaces Amaçlanan kapsam ChatOpenAI ve OpenAIEmbeddings’dir; satıcıya özgü ekstralar kapsam dışıdır LlamaIndex Python Supported via OpenAILike LemonData gibi üçüncü taraf gateway’ler için dahili OpenAI sınıfları yerine OpenAILike kullanın Dify - Supported with scope limits OpenAI sağlayıcısı ve chat-completions odaklı akışlar amaçlanan yoldur; Codex-özel Responses veya WebSocket davranışı için uygun değildir
Chat Completions Parametreleri Temel Parametreler Parametre Tip Açıklama modelstring Model tanımlayıcısı (gerekli) messagesarray Konuşma mesajları (gerekli) max_tokensinteger Maksimum çıktı token sayısı temperaturenumber Örnekleme sıcaklığı (0-2) top_pnumber Nucleus örnekleme (0-1) streamboolean Akışı etkinleştirir
Araç Çağrısı { "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 Object { "type": "function", "function": { "name": "fn" } }Belirli bir fonksiyonu zorla Anthropic Object { "type": "tool", "name": "fn", "disable_parallel_tool_use": true }Anthropic yerel formatı
Gelişmiş Parametreler Parametre Tip Açıklama stream_optionsobject Token sayımları için { include_usage: true } reasoning_effortstring Reasoning etkin GPT-5 modelleri için "low", "medium", "high" service_tierstring "auto" veya "default"seedinteger Deterministik çıktılar logprobsboolean Log olasılıklarını döndürür top_logprobsinteger En iyi log olasılık sayısı (0-20) logit_biasobject Token bias haritası (-100 ile 100 arası) frequency_penaltynumber Tekrar cezalandırma (-2 ile 2 arası) presence_penaltynumber Konu cezalandırması (-2 ile 2 arası) stopstring/array Durdurma dizileri ninteger Tamamlama sayısı (1-128) userstring İzleme için kullanıcı tanımlayıcısı
OpenAI Gelişmiş Özellikleri Parametre Tip Açıklama modalitiesarray Çok modlu için ["text", "audio"] audioobject Ses çıktısı yapılandırması (voice, format) predictionobject Daha hızlı tamamlamalar için tahmini çıktı metadataobject İzleme için anahtar-değer çiftleri storeboolean Daha sonra alınmak üzere saklama
Sağlayıcıya Özgü 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 Tip Açıklama modelstring Model tanımlayıcısı messagesarray Konuşma mesajları max_tokensinteger Maksimum çıktı (128000’e kadar) systemstring/array Sistem promptu streamboolean Akışı etkinleştirir
Araç Çağrısı { "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 { "model" : "claude-opus-4-6" , "thinking" : { "type" : "enabled" , "budget_tokens" : 10000 } }
Responses API Parametreleri Temel Parametreler Parametre Tip Açıklama modelstring Model tanımlayıcısı inputstring/array Girdi içeriği instructionsstring Sistem talimatları max_output_tokensinteger Maksimum çıktı token sayısı previous_response_idstring Konuşmaya devam etme
Gelişmiş Parametreler Parametre Tip Açıklama truncation_strategystring "auto" veya "disabled"includearray ["reasoning.encrypted_content"]reasoning_effortstring 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 compatibility) { "name" : "fn" , "input_schema" : { ... } }
Gemini API Parametreleri Temel Parametreler Parametre Tip Açıklama contentsarray Konuşma içeriği systemInstructionobject Sistem promptu generationConfigobject Üretim ayarları
Araçlar { "tools" : [{ "functionDeclarations" : [{ "name" : "search" , "description" : "Search the web" , "parameters" : { ... } }], "codeExecution" : {}, "googleSearch" : {} }], "toolConfig" : { "functionCallingConfig" : { "mode" : "AUTO" } } }
Güvenlik Ayarları { "safetySettings" : [ { "category" : "HARM_CATEGORY_HARASSMENT" , "threshold" : "BLOCK_MEDIUM_AND_ABOVE" } ] }
Ek Parametreler Parametre Tip 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 endpoint’ler 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}' # With usage tracking -d '{"...", "stream_options": {"include_usage": true}}'
Hata İşleme LemonData, OpenAI-uyumlu hata yanıtları döndürür:
{ "error" : { "message" : "Invalid API key" , "type" : "invalid_api_key" , "code" : "invalid_api_key" } }
Ayrıntılar için Hata İşleme Rehberi bakınız.
En İyi Uygulamalar
Bilinmeyen parametreler için passthrough kullanın
Tüm şemalar .passthrough() kullanır - bilinmeyen parametreler yukarı sağlayıcılara iletilir.
Doğru faturalama için stream_options tercih edin
Akış yanıtlarında doğru token sayımları için stream_options.include_usage’ı etkinleştirin.
Uygun tool_choice formatını kullanın
SDK’nızın beklediği formata uyun. LemonData hem OpenAI hem de Anthropic formatlarını kabul eder.
