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

# Claude API hızlı başlangıç: CometAPI ile Messages istekleri gönderin

> Claude modellerini CometAPI'nin Anthropic uyumlu Messages API'si üzerinden curl, Python ve Node.js ile çağırın.

## Ne oluşturacaksınız

`POST /v1/messages` adresine bir istek gönderecek, Claude yanıt metnini yazdıracak ve kodu Anthropic SDK veya doğrudan HTTP kullanımı için hazır tutacaksınız.

## Ön koşullar

* `COMETAPI_KEY` içinde saklanan bir CometAPI API anahtarı
* [Models sayfasından](/tr/overview/models) bir Claude model ID
* `curl`, Python 3.10+ veya Node.js 18+

## API anahtarı, temel URL, kimlik doğrulama

Anthropic uyumlu Messages endpoint'ini CometAPI üzerinden kullanın:

```text theme={null}
https://api.cometapi.com/v1/messages
```

Doğrudan HTTP isteklerini `x-api-key` ve Anthropic API sürüm başlığı ile doğrulayın:

```text theme={null}
x-api-key: $COMETAPI_KEY
anthropic-version: 2023-06-01
```

## Kod örnekleri

Kopyalanabilir cURL, Python ve Node.js örnekleri için aşağıdaki sekmeleri kullanın.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/messages \
    -H "Content-Type: application/json" \
    -H "x-api-key: $COMETAPI_KEY" \
    -H "anthropic-version: 2023-06-01" \
    -d '{
      "model": "your-claude-model-id",
      "max_tokens": 256,
      "messages": [
        {
          "role": "user",
          "content": "Reply with one short sentence."
        }
      ]
    }'
  ```

  ```python Python theme={null}
  import os
  import anthropic

  client = anthropic.Anthropic(
      api_key=os.environ["COMETAPI_KEY"],
      base_url="https://api.cometapi.com",
  )

  message = client.messages.create(
      model="your-claude-model-id",
      max_tokens=256,
      messages=[
          {
              "role": "user",
              "content": "Reply with one short sentence.",
          }
      ],
  )

  print(message.content[0].text)
  ```

  ```javascript Node.js theme={null}
  import Anthropic from "@anthropic-ai/sdk";

  const client = new Anthropic({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com",
  });

  const message = await client.messages.create({
    model: "your-claude-model-id",
    max_tokens: 256,
    messages: [
      {
        role: "user",
        content: "Reply with one short sentence.",
      },
    ],
  });

  console.log(message.content[0].text);
  ```
</CodeGroup>

## Akış açıklaması

Claude Messages istekleri varsayılan olarak senkrondur. API, tek bir HTTP yanıtında bir mesaj nesnesi döndürür ve uygulamanız ilk metin içerik bloğunu okur.

Anthropic mesaj dizileri, extended thinking, prompt caching veya tool use gibi Claude'a özgü istek biçimlerine ihtiyaç duyduğunuzda bu rotayı kullanın. Uygulamanız zaten resmi Anthropic SDK'yı kullanıyorsa, SDK temel URL'sini `https://api.cometapi.com` olarak ayarlayın ve Messages API istek biçimini koruyun.

## Yaygın parametreler

| Parameter    | Kullanım                                                                       |
| ------------ | ------------------------------------------------------------------------------ |
| `model`      | Hesabınız için kullanılabilir bir Claude model ID.                             |
| `max_tokens` | Messages API yanıtı için maksimum yanıt Token bütçesi.                         |
| `messages`   | `user` ve `assistant` rollerini içeren Anthropic mesaj dizisi.                 |
| `stream`     | `true` olarak ayarlandığında artımlı mesaj olaylarını stream eder.             |
| `thinking`   | Seçilen model destekliyorsa Claude extended thinking özelliğini etkinleştirir. |

## Sorun giderme / SSS

<AccordionGroup>
  <Accordion title="İstek 401 döndürüyor">
    `COMETAPI_KEY` değişkeninin, isteği gönderen aynı kabukta veya çalışma zamanında ayarlandığını doğrulayın. Gerçek bir anahtarı kaynak dosyalara yapıştırmayın.
  </Accordion>

  <Accordion title="SDK hâlâ doğrudan Anthropic'i çağırıyor">
    SDK istemcisinin Python'da `base_url` veya Node.js'te `baseURL` değerini `https://api.cometapi.com` olarak ayarladığını doğrulayın.
  </Accordion>

  <Accordion title="Hangi modeli kullanmalıyım">
    Hesabınız için kullanılabilir bir Claude model ID kullanın. Kullanılabilirlik hesap ve model ailesine göre değiştiği için bu hızlı başlangıç belirli bir Claude modelini sabit kodlamaz.
  </Accordion>
</AccordionGroup>

## Sonraki adımlar

* Tüm istek ve yanıt alanları için [Anthropic Messages API referansını](/api/text/anthropic-messages) kullanın.
* [Models](/tr/overview/models) içinde model kullanılabilirliğini kontrol edin.
* Yerel kodlama oturumlarını [Claude Code entegrasyon kılavuzu](/tr/integrations/claude-code) ile yapılandırın.
* [Hata kodları ve yeniden deneme stratejisi](/tr/guides/error-codes-and-retry-strategy) içinde yeniden deneme davranışını inceleyin.