✨ LemonData API Entegrasyon Yeteneği

Agent-First hata kurtarma ile, herhangi bir kodlama ajanı için paylaşılan LemonData API entegrasyon yeteneğini yükleyin.

Bu yetenek, kodlama ajanınıza yalnızca neye ihtiyacınız olduğunu açıklayarak LemonData’nın yüzlerce AI API’sini nasıl entegre edeceğini öğretir. Tek bir paylaşılan Agent-First yeteneği olarak paketlenmiştir ve skill veya rules dosyalarını destekleyen herhangi bir kodlama ajanı ile çalışır.

API Agent-First yaklaşımındadır — ajan bir model adını yanlış tahmin etse bile, hata yanıtı bunu tam olarak nasıl düzelteceğini söyler.

Bu sayfa yeniden kullanılabilir bir yetenek paketleme katmanını açıklar; bir protokol uyumluluk yüzeyi değildir. Uç nokta, SDK veya istemci kurulumu gerekiyorsa ilgili araçların özel entegrasyon sayfalarını kullanın.

Tür: Paylaşılan yetenek

Birincil yol: Yeniden kullanılabilir paylaşılan yetenek üzerinden yönlendirilmiş API kullanımı

Destek seviyesi: En iyi çaba

​

Nasıl Çalışır

1. Neye ihtiyacınız olduğunu açıklarsınız — “Python projemde GPT-4 kullanmak istiyorum”
2. Ajan API’yi çağırır — bir model adını veya uç noktayı tahmin edebilir
3. Herhangi bir sorun olursa — API yapılandırılmış ipuçları döndürür (did_you_mean, suggestions, retry_after)
4. Agent kendini düzeltir — ipuçlarını okur ve doğru parametrelerle yeniden dener
5. Çalışan kodu alırsınız — genellikle ilk veya ikinci denemede

​

Kurulum

Kanonik non-interactive kurulum komutunu kullanın:

npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y

Bu, LemonData skills deposundan paylaşılan lemondata-api-integration yeteneğini yükler.

Aracınız yükleyiciyi desteklemiyorsa, depodaki skills/lemondata-api-integration/ klasörünü aracınızın paylaşılan yetenek veya rules dizinine kopyalayın.

​

Kurulumu Doğrulama

Kodlama ajanınıza şunu sorun:

Hangi yetenekler kullanılabilir?

lemondata-api-integration görüyorsanız, kurulum başarılı olmuştur.

​

API Key’inizi Alın

1. LemonData'yı Ziyaret Edin

   lemondata.cc adresine gidin

2. Oturum Açın

   Bir hesap oluşturun veya giriş yapın

3. API Key Alın

   Dashboard → API Keys sayfasına gidin ve yeni bir key oluşturun

4. Key'i Kopyalayın

   Key’iniz sk-... ile başlar — güvenli bir şekilde saklayın

API key değerini promptlara veya kaynak dosyalara yapıştırmanız gerekmez. Yetenek hangi ortam değişkeninin kullanılacağını sormalı ve key değerini o değişkenden okuyan kod üretmelidir.

​

Örnekler

​

Sohbet Tamamlama

Siz şunu dersiniz:

Python projemde GPT-4 kullanmak istiyorum

Ajan şunu üretir:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LEMONDATA_API_KEY"],
    base_url="https://api.lemondata.cc/v1"
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

Şununla çalıştırın:

export LEMONDATA_API_KEY="sk-your-api-key"
python app.py

Ajan yanlış bir model adı tahmin ederse (ör. gpt5), API şunu döndürür:

{
  "error": {
    "code": "model_not_found",
    "did_you_mean": "gpt-5.4",
    "suggestions": [{"id": "gpt-5.4"}, {"id": "gpt-5-mini"}],
    "hint": "Did you mean 'gpt-5.4'? Use GET https://api.lemondata.cc/v1/models to list all available models."
  }
}

Ajan did_you_mean değerini okur, model adını düzeltir ve yeniden dener — hepsi otomatik olarak.

​

Görsel Oluşturma

Siz şunu dersiniz:

Node.js ile Flux kullanarak görsel oluştur

Ajan görsel API’sini çağırır, hataları işler ve indirme ile kaydetme mantığını içeren tam kod üretir.

​

Konuşma Tanıma

Siz şunu dersiniz:

Uygulamama speech-to-text entegre et

Ajan, doğru /v1/audio/transcriptions uç noktası ve ses dosyası işleme ile kod üretir.

​

Agent-First Hata Kurtarma

Her hata yanıtı, herhangi bir kodlama ajanının ayrıştırabileceği yapılandırılmış ipuçları içerir. Ayrıntılar için tam Agent-First API referansına bakın.

Hata	API’nin Döndürdüğü	Ajanın Yaptığı
Yanlış model adı	did_you_mean + suggestions	Otomatik düzeltir ve yeniden dener
Yetersiz bakiye	balance_usd + daha ucuz suggestions	Uygun fiyatlı modele geçer
Model kullanılamıyor	alternatives + retry_after	Kullanılabilir modele geçer
Hız sınırına takıldı	retry_after (tam saniye)	Bekler ve yeniden dener
Context çok uzun	daha büyük modellere sahip suggestions	Daha büyük context modeline geçer
Chat dışı istek sözleşmesi uyuşmazlığı	supported_operations, supported_parameters, request_endpoint, recommended_request	İsteği modelin public contract bilgisinden yeniden oluşturur

​

Native Uç Nokta Optimizasyonu

/v1/chat/completions çağrısını bir Claude veya Gemini modeliyle yaptığınızda, API optimizasyon header’ları döndürür:

X-LemonData-Hint: This model supports native Anthropic format. Use POST /v1/messages for better performance.
X-LemonData-Native-Endpoint: /v1/messages

Bu header’ları zorunlu otomatik geçiş değil, yönlendirme ipucu olarak değerlendirin. Claude native çağrıları /v1/messages kullanır; Gemini native çağrıları X-LemonData-Native-Endpoint tarafından bildirilen endpoint’i, genellikle /v1beta/gemini yolunu izlemelidir.

​

Model Keşfi

Dokümantasyonda arama yapmanıza gerek yok:

# Makine tarafından okunabilir API genel görünümü
curl https://api.lemondata.cc/llms.txt

# List models by category
curl "https://api.lemondata.cc/v1/models?category=chat" -H "Authorization: Bearer sk-KEY"
curl "https://api.lemondata.cc/v1/models?category=image" -H "Authorization: Bearer sk-KEY"

# Chat dışı senaryolar için önerilen liste
curl "https://api.lemondata.cc/v1/models?recommended_for=image" -H "Authorization: Bearer sk-KEY"
curl "https://api.lemondata.cc/v1/models?recommended_for=translation" -H "Authorization: Bearer sk-KEY"

# Chat dışı isteği tekrar denemeden önce bir modelin public contract bilgisini okuyun
curl "https://api.lemondata.cc/v1/models/gpt-image-2" -H "Authorization: Bearer sk-KEY"

# Yeteneğe göre filtrele
curl "https://api.lemondata.cc/v1/models?tag=coding" -H "Authorization: Bearer sk-KEY"

​

Desteklenen Yetenekler

Tür	Örnekler
Sohbet	GPT-5.4, Claude, Gemini, DeepSeek
Görsel Oluşturma	GPT Image, Flux, Stable Diffusion, Gemini görsel modelleri
Video Oluşturma	Sora, Kling, Veo, Seedance
Müzik Oluşturma	Suno
3D Modeller	Tripo3D
Ses	Metinden konuşmaya, konuşmadan metne
Gömlemeler	text-embedding-3
Yeniden Sıralama	bce-reranker, qwen3-rerank

​

En İyi Uygulamalar

API Key Güvenliği

Environment variable’ları kullanın. Key’leri asla git’e commit etmeyin veya frontend kodunda açığa çıkarmayın.

Maliyet Yönetimi

dashboard üzerinde kullanım limitleri belirleyin. Maliyetleri programatik olarak izlemek için error.balance_usd değerini kontrol edin.

Doğrudan Olun

“LemonData’nın bir görsel API’si var mı?” yerine “Python’da görsel üretmek istiyorum” deyin.

Senaryonuzu Açıklayın

“GPT-4 kullan” yerine “GPT-4 ile bir chatbot geliştiriyorum” demek, agent’e daha fazla context sağlar.

​

SSS

Skill otomatik olarak tetiklenmiyor mu?

İsteğinizde “LemonData” veya “LemonData API” ifadesini belirtmeyi deneyin:

Projeme GPT-4 entegre etmek için LemonData kullan

API, agent'in doğru modeli bulmasına nasıl yardımcı olur?

LemonData’nın Agent-First API’si yapılandırılmış hata ipuçları döndürür. Agent yanlış bir model adı tahmin ederse, hata doğru adla birlikte did_you_mean ve alternatiflerle birlikte suggestions içerir. Agent bunları okur ve bir sonraki denemede otomatik düzeltme yapar.

Hangi coding agent'ler destekleniyor?

Paylaşılan skill veya rules dizinlerini destekleyen herhangi bir coding agent. Yükleyici desteklendiğinde, npx skills add paylaşılan lemondata-api-integration skill’ini algılanan konuma otomatik olarak yerleştirir.

Skill nasıl güncellenir?

Yükleyiciyi yeniden çalıştırın:

npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y

​

Kaynaklar

Agent-First API

Yapılandırılmış hata ipuçları için tam referans

API Dokümantasyonu

Tam API referansı

Modeller

Mevcut yüzlerce modeli inceleyin

llms.txt

AI agent’leri için makine tarafından okunabilir API genel görünümü

Sorularınız mı var? GitHub Issues sayfamıza göz atın veya [e-mail] ile iletişime geçin