Ana içeriğe atla
Sunra, her biri farklı bir format izleyen üç LLM API endpoint’i sunar. Üçü de aynı kimlik doğrulama ve temel URL’yi (https://api-llm.sunra.ai) kullanır, bu sayede stack’inize en uygun formatı seçebilirsiniz. Başlamadan önce, kontrol panelinizden bir API anahtarı alın.

Chat Completions — /v1/chat/completions

Chat Completions endpoint’i OpenAI Chat Completions formatını izler. Roller (system, user, assistant) içeren bir mesaj listesi kabul eder ve bir yanıt döndürür. OpenAI SDK’ları ve araçlarıyla doğrudan uyumluluk istediğinizde bu endpoint’i kullanın. Temel özellikler: streaming, fonksiyon çağırma, görüntü işleme (resimler, ses, video, dosyalar), akıl yürütme, yapılandırılmış çıktılar (JSON schema / gramer), logprobs.
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?" }
    ]
  }'

Anthropic Messages — /v1/messages

Anthropic Messages endpoint’i Anthropic Messages API formatını izler. Zengin içerik blokları ile user / assistant mesaj rollerini ve ayrı bir system parametresini kullanır. Anthropic Claude modellerine ve genişletilmiş düşünme, prompt önbellekleme, alıntılar ve yerleşik araçlar (web araması, kod çalıştırma) gibi özelliklere yerel erişim istediğinizde bu endpoint’i kullanın. Temel özellikler: streaming, genişletilmiş düşünme, prompt önbellekleme, araç kullanımı (özel + yerleşik), PDF/belge girişi, alıntılar, yapılandırılmış çıktılar.
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?" }
    ]
  }'

Responses — /v1/responses

Responses endpoint’i OpenAI Responses API formatını izler. Esnek giriş öğeleri (mesajlar, fonksiyon çağrıları, akıl yürütme) kabul eder ve yapılandırılmış çıktı öğeleri döndürür. Yerleşik web araması, dosya araması, kod yorumlayıcı, bilgisayar kullanımı, MCP araç entegrasyonu veya görsel oluşturma gibi en son OpenAI Responses özelliklerine ihtiyaç duyduğunuzda bu endpoint’i kullanın. Temel özellikler: streaming, fonksiyon çağırma, web araması, dosya araması, kod yorumlayıcı, bilgisayar kullanımı, MCP araçları, görsel oluşturma, akıl yürütme, yapılandırılmış çıktılar.
curl -X POST https://api-llm.sunra.ai/v1/responses \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "input": [
      { "type": "message", "role": "user", "content": "Hello, how are you?" }
    ]
  }'

Doğru endpoint’i seçmek

Chat CompletionsAnthropic MessagesResponses
FormatOpenAI ChatAnthropic MessagesOpenAI Responses
En uygunOpenAI SDK uyumluluğuClaude-yerel özelliklerEn son OpenAI özellikleri
StreamingSSESSESSE
Fonksiyon çağırmaEvetEvet (özel + yerleşik)Evet
Akıl yürütmeEvetGenişletilmiş düşünmeEvet
Yapılandırılmış çıktıJSON schema, gramerJSON schemaJSON schema
Yerleşik araçlarWeb araması, kod çalıştırmaWeb araması, dosya araması, kod yorumlayıcı, bilgisayar kullanımı, MCP
Üç endpoint de aynı kimlik doğrulamayı paylaşır — API anahtarınızı Authorization başlığında Bearer token olarak geçirmeniz yeterlidir.