Ana içeriğe atla

​
İstek Gövdesi

​
model
string
gerekli
Kullanılacak modelin kimliği. Mevcut seçenekler için Models bölümüne bakın.When content is an array, LemonData supports structured multimodal blocks for compatible models:
  • text: { "type": "text", "text": "..." }
  • image: { "type": "image_url", "image_url": { "url": "https://..." } }
  • video: { "type": "video_url", "video_url": { "url": "https://..." } }
  • audio: { "type": "audio_url", "audio_url": { "url": "https://..." } }
For multimodal production traffic, prefer public https URLs. LemonData will translate these media blocks into the provider-specific request shape required by the routed physical model.
​
messages
array
gerekli
Konuşmayı oluşturan mesajların listesi.Her mesaj nesnesi şunları içerir:
  • role (string): system, user veya assistant
  • content (string | array): Mesaj içeriği
​
temperature
number
varsayılan:"1"
0 ile 2 arasında örnekleme sıcaklığı. Daha yüksek değerler çıktıyı daha rastgele hale getirir.
​
max_tokens
integer
Oluşturulacak maksimum token sayısı.
​
stream
boolean
varsayılan:"false"
True ise, kısmi mesaj delta’ları SSE event’leri olarak gönderilir.
​
stream_options
object
Streaming için seçenekler. Stream chunk’larında token kullanımını almak için include_usage: true ayarlayın.
​
top_p
number
varsayılan:"1"
Nucleus sampling parametresi. Bunun veya temperature değerinin değiştirilmesini öneririz, ikisinin birden değil.
​
frequency_penalty
number
varsayılan:"0"
-2.0 ile 2.0 arasında bir sayı. Pozitif değerler tekrar eden token’ları cezalandırır.
​
presence_penalty
number
varsayılan:"0"
-2.0 ile 2.0 arasında bir sayı. Pozitif değerler metinde zaten bulunan token’ları cezalandırır.
​
stop
string | array
API’nin token üretmeyi durduracağı en fazla 4 dizi.
​
tools
array
Modelin çağırabileceği araçların listesi (function calling).
​
tool_choice
string | object
Modelin araçları nasıl kullandığını kontrol eder. Seçenekler: auto, none, required veya belirli bir araç nesnesi.
​
parallel_tool_calls
boolean
varsayılan:"true"
Paralel function calling’in etkinleştirilip etkinleştirilmeyeceği. Function’ları sıralı çağırmak için false olarak ayarlayın.
​
max_completion_tokens
integer
Completion için maksimum token sayısı. max_tokens için bir alternatiftir; daha yeni reasoning özellikli model aileleri için kullanışlıdır.
​
reasoning_effort
string
Reasoning özellikli modeller için reasoning çabası. Seçenekler: low, medium, high.
​
seed
integer
Deterministik örnekleme için rastgele seed.
​
n
integer
varsayılan:"1"
Oluşturulacak completion sayısı (1-128).
​
logprobs
boolean
Log olasılıklarının döndürülüp döndürülmeyeceği.
​
top_logprobs
integer
Döndürülecek en yüksek log olasılığı sayısı (0-20). logprobs: true gerektirir.
​
top_k
integer
Top-K sampling parametresi (Anthropic/Gemini modelleri için).
​
response_format
object
Yanıt biçimi belirtimi. JSON modu için {"type": "json_object"}, yapılandırılmış çıktılar için ise {"type": "json_schema", "json_schema": {...}} kullanın.
​
logit_bias
object
Belirtilen token’ların görünme olasılığını değiştirir. Token ID’lerini (string olarak) -100 ile 100 arasındaki bias değerlerine eşleyin.
​
user
string
Kötüye kullanım izleme için son kullanıcınızı temsil eden benzersiz bir tanımlayıcı.
​
cache_control
object
LemonData cache control seçenekleri.
  • type (string): Cache stratejisi - default, no_cache, no_store, response_only, semantic_only
  • max_age (integer): Saniye cinsinden cache TTL değeri (maksimum 86400)

​
Yanıt

​
id
string
Completion için benzersiz tanımlayıcı.
​
object
string
Her zaman chat.completion.
​
created
integer
Completion’ın oluşturulduğu zamanın Unix timestamp değeri.
​
model
string
Completion için kullanılan model.
​
choices
array
Completion seçeneklerinin listesi.Her seçenek şunları içerir:
  • index (integer): Seçeneğin indeksi
  • message (object): Oluşturulan mesaj
  • finish_reason (string): Modelin neden durduğu (stop, length, tool_calls)
​
usage
object
Token kullanım istatistikleri.
  • prompt_tokens (integer): Prompt içindeki token’lar
  • completion_tokens (integer): Completion içindeki token’lar
  • total_tokens (integer): Kullanılan toplam token
curl -X POST "https://api.lemondata.cc/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "temperature": 0.7,
    "max_tokens": 1000
  }'

​
Multimodal Example

{
  "model": "gemini-2.5-pro",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Describe this video briefly." },
        { "type": "video_url", "video_url": { "url": "https://example.com/demo.mp4" } }
      ]
    }
  ],
  "max_tokens": 64
}

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1706000000,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 9,
    "total_tokens": 29
  }
}