> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# LLM Hızlı Başlangıç

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](https://sunra.ai/dashboard/api-tokens) bir API anahtarı alın.

## Chat Completions — `/v1/chat/completions`

[Chat Completions](/tr/llm/chat) 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.

```bash theme={null}
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](/tr/llm/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.

```bash theme={null}
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](/tr/llm/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.

```bash theme={null}
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 Completions      | Anthropic Messages          | Responses                                                              |
| ------------------------- | --------------------- | --------------------------- | ---------------------------------------------------------------------- |
| **Format**                | OpenAI Chat           | Anthropic Messages          | OpenAI Responses                                                       |
| **En uygun**              | OpenAI SDK uyumluluğu | Claude-yerel özellikler     | En son OpenAI özellikleri                                              |
| **Streaming**             | SSE                   | SSE                         | SSE                                                                    |
| **Fonksiyon çağırma**     | Evet                  | Evet (özel + yerleşik)      | Evet                                                                   |
| **Akıl yürütme**          | Evet                  | Genişletilmiş düşünme       | Evet                                                                   |
| **Yapılandırılmış çıktı** | JSON schema, gramer   | JSON schema                 | JSON schema                                                            |
| **Yerleşik araçlar**      | —                     | Web araması, kod çalıştırma | Web 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.