Ana içeriğe atla
POST
/
v1
/
messages
curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Hello, how are you?"
      }
    ]
  }'
{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! I'm doing well, thank you for asking."
    }
  ],
  "model": "anthropic/claude-sonnet-4-20250514",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 15
  }
}
Anthropic Messages API formatını kullanarak bir mesaj oluşturur. Metin, görüntüler, PDF’ler, araçlar ve genişletilmiş düşünmeyi destekler.

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
Mesaj için kullanılacak model. Mevcut modelleri sunra.ai/models adresinde inceleyin.
messages
object[]
gerekli
Konuşma için giriş mesajlarının listesi.
max_tokens
integer
gerekli
Durdurmadan önce üretilecek maksimum token sayısı.
system
string
Sistem istemi. Modelin uyması gereken talimatları sağlar.
stream
boolean
varsayılan:false
Yanıtın server-sent events (SSE) kullanılarak akışla iletilip iletilmeyeceği.
temperature
number
Yanıta enjekte edilen rastgelelik miktarı. 0.0 ile 1.0 arasında değişir.
top_p
number
Çekirdek örnekleme parametresi. 0 ile 1 arasında bir değer kullanın.
top_k
integer
Her sonraki token için yalnızca en iyi K seçenekten örnekleyin. “Uzun kuyruk” düşük olasılıklı yanıtları kaldırmak için kullanılır.
stop_sequences
string[]
Modelin üretmeyi durduracağı özel metin dizileri.
metadata
object
İstek hakkında meta verileri açıklayan bir nesne.

Yanıt

Başarılı mesaj yanıtı.
id
string
Benzersiz mesaj tanımlayıcısı.
type
string
Nesne türü. Her zaman message.
role
string
Üretilen mesajın rolü. Her zaman assistant.
content
object[]
Yanıttaki içerik bloklarının listesi.
model
string
İsteği işleyen model.
stop_reason
string
Modelin üretmeyi durdurma nedeni. end_turn, max_tokens, stop_sequence veya tool_use olabilir.
stop_sequence
string | null
Modelin durmasına neden olan durdurma dizisi, varsa.
usage
object
Token kullanım istatistikleri.
curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Hello, how are you?"
      }
    ]
  }'
{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! I'm doing well, thank you for asking."
    }
  ],
  "model": "anthropic/claude-sonnet-4-20250514",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 15
  }
}