Ana içeriğe atla

​
Genel Bakış

LemonData API, OpenAI-uyumludur; bu, resmi OpenAI SDK’sını yalnızca base URL değişikliği ile kullanabileceğiniz anlamına gelir. Çoğu entegrasyon için POST /v1/chat/completions ile başlayın. Ayrıca yerel Anthropic ve Gemini istek formatlarını ve gelişmiş isteğe bağlı yol olarak POST /v1/responses’ı destekliyoruz.

​
Base URL

https://api.lemondata.cc

​
Kimlik Doğrulama

Tüm API uç noktaları Bearer token kullanılarak kimlik doğrulaması gerektirir: 
Authorization: Bearer sk-your-api-key
API anahtarınızı Kontrol Paneli üzerinden alın.
Etkileşimli Playground Hakkında: Bu dokümantasyon sitesindeki playground yalnızca gösterim amaçlıdır ve API anahtarı girilmesine izin vermez. API’yi test etmek için lütfen:
  • cURL - Örnek komutları kopyalayın ve sk-your-api-key yerine gerçek anahtarınızı koyun
  • Postman - OpenAPI spesifikasyonumuzu içe aktarın
  • SDK - base URL olarak bizim URL’imizi kullanarak OpenAI/Anthropic SDK’sını kullanın

​
Desteklenen Uç Noktalar

​
Sohbet & Metin Üretimi

Uç NoktaYöntemAçıklama
/v1/chat/completionsPOSTOpenAI uyumlu sohbet tamamlamaları
/v1/messagesPOSTAnthropic uyumlu mesajlar API’si
/v1/responsesPOSTOpenAI Responses API

​
Embeddings & Yeniden Sıralama

Uç NoktaYöntemAçıklama
/v1/embeddingsPOSTMetin embedding’leri oluşturma
/v1/rerankPOSTDokümanları yeniden sıralama

​
Görseller

Uç NoktaYöntemAçıklama
/v1/images/generationsPOSTMetinden görsel oluşturma
/v1/images/editsPOSTGörselleri düzenleme
/v1/images/generations/{id}GETGörev tabanlı görsel yanıtlar için görsel görev durumu yolu
Bazı görsel modeller sonuçları doğrudan döndürebilir, bazıları görev tabanlı yanıtlar verebilir ve bazıları yönlendirilen sağlayıcı yoluna bağlı olarak her iki şekilde davranabilir. Create yanıtı poll_url içeriyorsa, tam olarak onu izleyin.

​
Ses

Uç NoktaYöntemAçıklama
/v1/audio/speechPOSTMetinden sese (TTS)
/v1/audio/transcriptionsPOSTKonuşmadan metne (STT)

​
Video

Uç NoktaYöntemAçıklama
/v1/videos/generationsPOSTVideo üretim görevi oluşturma
/v1/tasks/{id}GETVideo işleri için asenkron görev durumu alma
/v1/videos/generations/{id}GETEski uyumluluğa uygun video görev durumu yolu
Yeni istemciler için, create yanıtları tarafından döndürülen poll_url’u takip etmeyi tercih edin. /v1/videos/generations/{id} yolunu yalnızca geriye dönük uyumluluk için tutun.

​
Asenkron Görevler

Uç NoktaYöntemAçıklama
/v1/tasks/{id}GETBirleştirilmiş asenkron görev durumu uç noktası. Döndürülen poll_url izlenirken önerilir
Bu uç nokta yalnızca video, müzik ve 3B ile sınırlı değildir. Bazı görsel görevleri de resmi sorgulama yolu olarak /v1/tasks/{id} kullanabilir.

​
Müzik

Uç NoktaYöntemAçıklama
/v1/music/generationsPOSTMüzik üretim görevi oluşturma
/v1/music/generations/{id}GETMüzik’e özgü durum yolu
Yeni istemciler için öncelikle döndürülen poll_url’u tercih edin. Sabit bir görev-durum uç noktasına ihtiyacınız varsa /v1/tasks/{id} kullanın; müzik’e özgü uyumluluk yolları için /v1/music/generations/{id}’i koruyun.

​
3B Üretimi

Uç NoktaYöntemAçıklama
/v1/3d/generationsPOST3B model üretim görevi oluşturma
/v1/3d/generations/{id}GET3B’ye özgü durum yolu
Yeni istemciler için öncelikle döndürülen poll_url’u tercih edin. Sabit bir görev-durum uç noktasına ihtiyacınız varsa /v1/tasks/{id} kullanın; 3B’ye özgü uyumluluk yolları için /v1/3d/generations/{id}’i koruyun.

​
Modeller

Uç NoktaYöntemAçıklama
/v1/modelsGETMevcut tüm modelleri listele
/v1/models/{model}GETBelirli model bilgilerini al

​
Gemini (v1beta)

Yerel Google Gemini API formatı desteği:
Uç NoktaYöntemAçıklama
/v1beta/models/{model}:generateContentPOSTİçerik oluşturma (Gemini formatı)
/v1beta/models/{model}:streamGenerateContentPOSTAkışlı içerik oluşturma (Gemini formatı)
Gemini uç noktaları, standart Bearer token’a ek olarak ?key= sorgu parametresi ile kimlik doğrulamayı da destekler.

​
Yanıt Formatı

Tüm yanıtlar tutarlı bir format izler:

​
Başarılı Yanıt

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o",
  "choices": [...],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

​
Yönlendirme Şeffaflığı

Tüm yanıtlar kanal bilgilerini içeren bir _routing alanı içerir: 
{
  "id": "chatcmpl-abc123",
  ...,
  "_routing": {
    "channel": {
      "id": "ch_xxx",
      "name": "channel-name",
      "provider": "openai",
      "channelType": "PLATFORM"
    },
    "cached": false,
    "retryCount": 0
  }
}
AlanAçıklama
channel.idKullanılan kanal tanımlayıcısı
channel.providerÜst akış sağlayıcısı (openai, anthropic, vb.)
channel.channelTypePLATFORM (LemonData) veya PRIVATE (BYOK)
cachedYanıtın önbellekten servis edilip edilmediği
retryCountYeniden deneme sayısı (varsa)

​
Hata Yanıtı

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

​
Hız Sınırları

Hız sınırları role dayalıdır ve yöneticiler tarafından yapılandırılabilir. Varsayılan değerler:
Rolİstek/dakika
Kullanıcı60
Ortak300
VIP1,000
Özel hız sınırları için destek ile iletişime geçin. Kesin değerler hesap yapılandırmasına göre değişebilir.
Hız sınırları aşıldığında, API beklemeniz gereken süreyi belirten bir Retry-After başlığı ile birlikte 429 durum kodu döndürür.

​
OpenAPI Spesifikasyonu

OpenAPI Spesifikasyonu

Tam OpenAPI 3.0 spesifikasyonunu indir