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

# Ses API'leri

> Metinden konuşma, transkripsiyon ve ses çevirisi iş akışları için CometAPI ses rotalarını seçin.

Uygulamanızın konuşma çıktısına, transkripsiyona veya çeviriye ihtiyaç duyup duymadığına göre seçim yaparak CometAPI ses modeli dokümantasyonunu kullanın. Ses endpoint'leri, diğer OpenAI uyumlu endpoint'lerle aynı CometAPI API anahtarı desenini kullanır.

## Bir ses API'si seçin

<CardGroup cols={3}>
  <Card title="Create speech" icon="microphone" href="/api/audio/create-speech">
    Metni konuşmaya dönüştürün.
  </Card>

  <Card title="Create transcription" icon="message" href="/api/audio/create-transcription">
    Sesi metne dönüştürün.
  </Card>

  <Card title="Create translation" icon="sparkles" href="/api/audio/create-translation">
    Sesi İngilizce metne çevirin.
  </Card>
</CardGroup>

## Create speech

[Models sayfasından](/tr/overview/models) veya [model dizininden](https://www.cometapi.com/models/) ses destekli bir model ID kullanın. Aşağıdaki örnekler konuşma endpoint'ini çağırır.

<Note>
  Bu örneklerde `your-audio-model-id` yer tutucusu kullanılır. İsteği çalıştırmadan önce bunu [Models sayfasından](/tr/overview/models) veya [model dizininden](https://www.cometapi.com/models/) kullanılabilir bir ses model ID ile değiştirin.
</Note>

<Tip>
  Playground'u ve endpoint şemasını kullanmak için [Create speech](/api/audio/create-speech) sayfasını açın.
</Tip>

<CodeGroup>
  ```python Python theme={null}
  import os
  import requests

  response = requests.post(
      "https://api.cometapi.com/v1/audio/speech",
      headers={
          "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
          "Content-Type": "application/json",
      },
      json={
          "model": "your-audio-model-id",
          "input": "Welcome to CometAPI.",
          "voice": "alloy",
          "response_format": "mp3",
      },
      timeout=60,
  )

  response.raise_for_status()

  with open("speech.mp3", "wb") as audio_file:
      audio_file.write(response.content)
  ```

  ```javascript Node.js theme={null}
  import { writeFile } from "node:fs/promises";

  const response = await fetch("https://api.cometapi.com/v1/audio/speech", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "your-audio-model-id",
      input: "Welcome to CometAPI.",
      voice: "alloy",
      response_format: "mp3",
    }),
  });

  if (!response.ok) {
    throw new Error(await response.text());
  }

  const audio = Buffer.from(await response.arrayBuffer());
  await writeFile("speech.mp3", audio);
  ```

  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/audio/speech \
    -H "Authorization: Bearer $COMETAPI_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "your-audio-model-id",
      "input": "Welcome to CometAPI.",
      "voice": "alloy",
      "response_format": "mp3"
    }' \
    --output speech.mp3
  ```
</CodeGroup>

## Yanıt örneği

Başarılı bir konuşma yanıtı ikili ses verisidir. HTTP yanıtı şöyle görünebilir:

```text theme={null}
HTTP/1.1 200 OK
Content-Type: audio/mpeg

speech.mp3
```

## Örnek model kayıtları

<Info>
  Bu örnek model katalog yanıtı, `/api/models` zarfını ve tek bir ses model kaydının şeklini gösterir. Tam bir model listesi değildir.
</Info>

```bash cURL theme={null}
curl https://api.cometapi.com/api/models
```

```json theme={null}
{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 0,
      "id": "your-audio-model-id",
      "code": "your-audio-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example audio model",
      "model_type": "audio",
      "features": [
        "text-to-speech"
      ],
      "endpoints": [
        "openai"
      ],
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 12,
        "output": 12,
        "per_request": null,
        "per_second": null
      }
    }
  ]
}
```

## Yaygın hatalar

<AccordionGroup>
  <Accordion title="Desteklenmeyen ses formatı">
    Endpoint sayfasında belgelenen formatları kullanın.
  </Accordion>

  <Accordion title="Büyük yükleme reddedildi">
    Ses dosyasını sıkıştırın veya işi daha küçük dosyalara bölün.
  </Accordion>

  <Accordion title="Boş transkripsiyon">
    Dosyanın konuşma içerdiğini ve alan adının dokümanlarla eşleştiğini doğrulayın.
  </Accordion>

  <Accordion title="Yanlış base URL">
    `https://api.cometapi.com/v1` kullanın.
  </Accordion>
</AccordionGroup>

## Hata kodları ve yeniden deneme stratejisi

<AccordionGroup>
  <Accordion title="400">
    Metin, dosya, model ID, voice veya format düzeltilene kadar yeniden denemeyin.
  </Accordion>

  <Accordion title="401">
    API anahtarı mevcut ve geçerli olana kadar yeniden denemeyin.
  </Accordion>

  <Accordion title="404">
    Yeniden denemeden önce base URL, path ve model ID değerlerini kontrol edin.
  </Accordion>

  <Accordion title="413">
    Yeniden denemeden önce yükleme boyutunu azaltın.
  </Accordion>

  <Accordion title="429">
    Üstel backoff ile yeniden deneyin ve eşzamanlılığı azaltın.
  </Accordion>

  <Accordion title="500 or 503">
    Geçici provider veya servis hataları için backoff ile yeniden deneyin.
  </Accordion>
</AccordionGroup>

<Tip>
  Uygulama kalıpları için [Hata kodları ve yeniden deneme stratejisi](/tr/guides/error-codes-and-retry-strategy) ve [Hız limitleri ve eşzamanlılık](/tr/guides/rate-limits-and-concurrency) bölümlerine bakın.
</Tip>

## Fiyatlandırma ve model dizini

<CardGroup cols={3}>
  <Card title="Models sayfası" icon="list" href="/overview/models">
    CometAPI'nin dokümanlarda model ID değerlerini nasıl sunduğunu öğrenin.
  </Card>

  <Card title="Model dizini" icon="puzzle-piece" href="https://www.cometapi.com/models/">
    Model kullanılabilirliğine ve yeteneklerine göz atın.
  </Card>

  <Card title="Fiyatlandırma" icon="tag" href="https://www.cometapi.com/pricing/">
    Bir modeli çağırmadan önce fiyatlandırmayı kontrol edin.
  </Card>
</CardGroup>