Chat Completions

Sohbet tamamlama API'si

Chat Completions API, konuşma tabanlı AI uygulamaları oluşturmanızı sağlar. Mesaj geçmişi göndererek bağlamsal ve tutarlı yanıtlar alabilirsiniz.

POST /v1/chat/completions

Verilen mesaj geçmişi için bir model yanıtı oluşturur.

Request Body

model string zorunlu

Kullanılacak modelin ID'si. Örnek: openai/gpt-4o-mini, anthropic/claude-3.5-sonnet

messages array zorunlu

Konuşma geçmişini içeren mesaj dizisi. Her mesaj role ve content alanlarını içermelidir.

temperature number opsiyonel

0 ile 2 arasında bir değer. Daha yüksek değerler daha yaratıcı, düşük değerler daha tutarlı yanıtlar üretir. Varsayılan: 1

max_tokens integer opsiyonel

Yanıtta üretilecek maksimum token sayısı.

stream boolean opsiyonel

true olarak ayarlandığında, yanıtlar Server-Sent Events olarak gerçek zamanlı akıtılır. Varsayılan: false

top_p number opsiyonel

Nucleus sampling parametresi. 0 ile 1 arasında. Varsayılan: 1

Mesaj Rolleri

Role	Açıklama
`system`	Asistanın davranışını belirleyen sistem talimatı
`user`	Kullanıcıdan gelen mesajlar
`assistant`	Asistanın önceki yanıtları

Örnek İstek

                cURL
                
            

curl https://api.onysoft.com/v1/chat/completions \
  -H "Authorization: Bearer sk-ony-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [
      {
        "role": "system",
        "content": "Sen yardımcı bir asistansın."
      },
      {
        "role": "user",
        "content": "Python'da liste nasıl oluşturulur?"
      }
    ],
    "temperature": 0.7,
    "max_tokens": 500
  }'
            

Örnek Yanıt

                JSON
            

{
  "id": "chatcmpl-abc123xyz",
  "object": "chat.completion",
  "created": 1706000000,
  "model": "openai/gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Python'da liste oluşturmanın birkaç yolu vardır:\n\n1. Köşeli parantez ile:\n```python\nmy_list = [1, 2, 3, 4, 5]\n```\n\n2. list() fonksiyonu ile:\n```python\nmy_list = list((1, 2, 3))\n```"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 95,
    "total_tokens": 123
  }
}
            