Ana içeriğe atla
Bu yetenek, kodlama ajanınıza yalnızca neye ihtiyacınız olduğunu açıklayarak LemonData’nın 300+ 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 yetenekBirincil yol: Yeniden kullanılabilir paylaşılan yetenek üzerinden yönlendirilmiş API kullanımıDestek seviyesi: Best-effort

​
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’i önceden yapılandırmanız gerekmez. Skill’i kullandığınızda, agent sizden key’inizi isteyecek ve bunu oluşturulan koda dahil edecektir.

​
Örnekler

​
Chat Completion

Siz şunu dersiniz: 
Python projemde GPT-4 kullanmak istiyorum
Ajan şunu üretir: 
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-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)
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.
HataAPI’nin DöndürdüğüAjanın Yaptığı
Yanlış model adıdid_you_mean + suggestionsOtomatik düzeltir ve yeniden dener
Yetersiz bakiyebalance_usd + daha ucuz suggestionsUygun fiyatlı modele geçer
Model kullanılamıyoralternatives + retry_afterKullanılabilir modele geçer
Rate limitedretry_after (tam saniye)Bekler ve yeniden dener
Context çok uzundaha büyük modellere sahip suggestionsDaha büyük context modeline geçer

​
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
Ajan daha iyi performans için otomatik olarak native uç noktaya geçer (format dönüştürme yok, extended thinking, prompt caching).

​
Model Keşfi

Dokümantasyonda arama yapmanıza gerek yok: 
# Machine-readable API overview
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"

# Filter by capability
curl "https://api.lemondata.cc/v1/models?tag=coding" -H "Authorization: Bearer sk-KEY"

​
Desteklenen Yetenekler

TürÖrnekler
ChatGPT-5.4, Claude, Gemini, DeepSeek
Görsel OluşturmaMidjourney, Flux, Stable Diffusion
Video OluşturmaSora, Runway, Kling, Luma AI
Müzik OluşturmaSuno
3D ModellerTripo3D
SesText-to-Speech, Speech-to-Text
Embeddingstext-embedding-3
Rerankbce-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

İsteğinizde “LemonData” veya “LemonData API” ifadesini belirtmeyi deneyin:
Projeme GPT-4 entegre etmek için LemonData kullan
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.
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.
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 300+ modelin tümüne göz atın

llms.txt

AI agent’leri için machine-readable API genel görünümü
Sorularınız mı var? GitHub Issues sayfamıza göz atın veya [email protected] ile iletişime geçin