Ana içeriğe atla
POST
/
v1
/
chat
/
completions
curl -X POST https://api-llm.sunra.ai/v1/chat/completions \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "What is the capital of France?"
      }
    ]
  }'

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "openai/gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The capital of France is Paris."
      },
      "finish_reason": "stop"
    }
  ],
  "system_fingerprint": "fp_44709d6fcb",
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 8,
    "total_tokens": 33
  }
}
Verilen sohbet konuşması için bir model yanıtı isteği gönderir. Hem akış hem de akış dışı modları destekler. OpenAI Chat Completions API formatıyla uyumludur.

​
Kimlik Doğrulama

​
Authorization
string
gerekli
Bearer token. Authorization başlığında API anahtarınızı bearer token olarak kullanın.Format: Bearer <SUNRA_KEY>

​
İstek

Bu endpoint bir JSON nesnesi bekler.
​
model
string
gerekli
Tamamlama için kullanılacak model. Mevcut modelleri sunra.ai/models adresinde inceleyin.
​
messages
object[]
gerekli
Konuşma için mesaj listesi.
​
stream
boolean
varsayılan:false
true olarak ayarlanırsa, kısmi mesaj deltaları server-sent events (SSE) olarak gönderilir.
​
max_tokens
integer
Tamamlamada üretilecek maksimum token sayısı.
​
temperature
number
0 ile 2 arasında örnekleme sıcaklığı. 0.8 gibi yüksek değerler çıktıyı daha rastgele yapar, 0.2 gibi düşük değerler daha odaklı ve belirleyici yapar.
​
top_p
number
Çekirdek örnekleme parametresi (0-1). Modelin top_p olasılık kütlesine sahip tokenleri değerlendirdiği, sıcaklık örneklemesine bir alternatif.
​
frequency_penalty
number
-2.0 ile 2.0 arasında bir sayı. Pozitif değerler, yeni tokenleri metindeki mevcut sıklıklarına göre cezalandırarak modelin aynı satırı kelimesi kelimesine tekrarlama olasılığını azaltır.
​
presence_penalty
number
-2.0 ile 2.0 arasında bir sayı. Pozitif değerler, yeni tokenleri metinde daha önce görünüp görünmediklerine göre cezalandırarak modelin yeni konular hakkında konuşma olasılığını artırır.
​
stop
string | string[]
API’nin daha fazla token üretmeyi durduracağı en fazla 4 dizi.

​
Yanıt

Başarılı sohbet tamamlama yanıtı.
​
id
string
Benzersiz tamamlama tanımlayıcısı.
​
object
string
Nesne türü. Her zaman chat.completion.
​
created
integer
Oluşturulma Unix zaman damgası.
​
model
string
Tamamlama için kullanılan model.
​
choices
object[]
Tamamlama seçeneklerinin listesi.
​
usage
object
Token kullanım istatistikleri.
curl -X POST https://api-llm.sunra.ai/v1/chat/completions \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "What is the capital of France?"
      }
    ]
  }'

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "openai/gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The capital of France is Paris."
      },
      "finish_reason": "stop"
    }
  ],
  "system_fingerprint": "fp_44709d6fcb",
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 8,
    "total_tokens": 33
  }
}