> ## 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.

# OpenAI uyumlu API hızlı başlangıç: CometAPI ile Chat Completions istekleri gönderin

> curl, Python, Node.js ve OpenAI SDK'leri ile Chat Completions istekleri için CometAPI'yi OpenAI API uyumlu bir base URL olarak kullanın.

Bu sayfa, CometAPI için OpenAI uyumlu bir API hızlı başlangıç kılavuzudur. Chat Completions istek yapısını, OpenAI SDK'lerini ve bir CometAPI base URL'sini yeniden kullanmanıza yardımcı olur. Bu sayfa bir OpenAI hesap kurulum kılavuzu veya yalnızca OpenAI modellerine yönelik bir sayfa değildir.

## Neler oluşturacaksınız

CometAPI'nin OpenAI uyumlu `POST /v1/chat/completions` rotasına bir metin isteği gönderecek, assistant mesajını yazdıracak ve istek yapısını zaten OpenAI SDK'lerini kullanan uygulamalar için hazır tutacaksınız.

## Bu sayfa ne zaman kullanılmalı

Aşağıdakilerden biri projenizle eşleşiyorsa bu hızlı başlangıç kılavuzunu kullanın:

* Zaten OpenAI SDK'lerini veya Chat Completions istek yapılarını kullanıyorsunuz.
* base URL'yi CometAPI'ye geçirmek istiyorsunuz.
* OpenAI API uyumlu bir rota üzerinden bir CometAPI model ID çağırmak istiyorsunuz.

## Ön koşullar

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

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

OpenAI uyumlu istemcilerle CometAPI base URL'sini kullanın:

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

Doğrudan HTTP isteklerini bir Bearer token ile kimlik doğrulayın:

```text theme={null}
Authorization: Bearer $COMETAPI_KEY
```

## Kod örnekleri

Aşağıdaki sekmeleri kullanarak aynı Chat Completions isteğini cURL, Python ve Node.js ile gönderin.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/chat/completions \
    -H "Authorization: Bearer $COMETAPI_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "your-model-id",
      "messages": [
        {
          "role": "user",
          "content": "Write one sentence about CometAPI."
        }
      ]
    }'
  ```

  ```python Python theme={null}
  import os
  from openai import OpenAI

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

  completion = client.chat.completions.create(
      model="your-model-id",
      messages=[
          {
              "role": "user",
              "content": "Write one sentence about CometAPI.",
          }
      ],
  )

  print(completion.choices[0].message.content)
  ```

  ```javascript Node.js theme={null}
  import OpenAI from "openai";

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

  const completion = await client.chat.completions.create({
    model: "your-model-id",
    messages: [
      {
        role: "user",
        content: "Write one sentence about CometAPI.",
      },
    ],
  });

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

## Akış açıklaması

OpenAI uyumlu olması, uygulamanızın Chat Completions endpoint'ini, istek gövdesini ve SDK metot adlarını korurken base URL ve model ID değerlerini CometAPI değerleriyle değiştirmesi anlamına gelir.

Rota varsayılan olarak eşzamanlıdır. API, tamamlanmış yanıt nesnesini tek bir HTTP yanıtında döndürür ve uygulamanız `choices[0].message.content` değerini okur.

Artımlı çıktı için `stream` değerini `true` olarak ayarlayın. Yanıt Server-Sent Events olur ve `data: [DONE]` ile sona erer. chat arayüzleri ve uzun yanıtlar için streaming kullanın. Arka plan işleri ve basit testler için eşzamanlı biçimi koruyun.

## Yaygın parametreler

| Parameter               | Kullanım                                                                                |
| ----------------------- | --------------------------------------------------------------------------------------- |
| `model`                 | Metin destekleyen bir model için CometAPI model ID.                                     |
| `messages`              | Konuşma dizisi. En basit istek için bir `user` mesajıyla başlayın.                      |
| `temperature`           | Rastgeleliği kontrol eder. Daha düşük değerler çıktıyı daha deterministik hale getirir. |
| `max_completion_tokens` | completion-token bütçeleri kullanan model aileleri için üretilen çıktıyı sınırlar.      |
| `stream`                | `true` olarak ayarlandığında artımlı yanıt parçalarını stream eder.                     |
| `response_format`       | Seçilen model destekliyorsa JSON çıktı ister.                                           |

## Sorun giderme ve SSS

<AccordionGroup>
  <Accordion title="Bu OpenAI API mi?">
    Hayır. Bu, CometAPI'nin OpenAI uyumlu API rotasıdır. Bir CometAPI API anahtarı, CometAPI base URL'si ve bir CometAPI model ID kullanırsınız.
  </Accordion>

  <Accordion title="İstek 401 döndürüyor">
    İsteği gönderen aynı shell veya runtime içinde `COMETAPI_KEY` ayarlandığını doğrulayın. Gerçek bir anahtarı kaynak dosyalara yapıştırmayın.
  </Accordion>

  <Accordion title="Model bulunamadı">
    Metin veya chat isteklerini destekleyen bir CometAPI model ID kullanın. Yeniden denemeden önce Models sayfasını kontrol edin.
  </Accordion>

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

## Sonraki adımlar

* [Chat Completions API referansını](/api/text/chat) okuyun.
* SDK client'larını [OpenAI SDK'leri ile CometAPI kullanın](/tr/guides/use-cometapi-with-openai-sdk) içinde yapılandırın.
* [Kullanılabilir CometAPI modellerini listeleyin](/tr/guides/how-to-list-available-models) ile kullanılabilir modelleri listeleyin.
* [Hata kodları ve yeniden deneme stratejisi](/tr/guides/error-codes-and-retry-strategy) ile yeniden deneme ve rate-limit işlemeyi ekleyin.