Ana içeriğe atla

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.

Uygulamanızın speech output, transcription veya translation ihtiyacına göre CometAPI audio model dokümantasyonunu kullanın. Audio endpoint’leri, diğer OpenAI-compatible endpoint’lerle aynı CometAPI API key kalıbını kullanır.

Bir audio API seçin

Create Speech

Metni speech’e dönüştürün.

Create Transcription

Audio’yu metne dönüştürün.

Create Translation

Audio’yu İngilizce metne çevirin.

Speech oluşturma

Models page ya da model directory içinden audio özellikli bir model ID kullanın. Aşağıdaki örnekler speech endpoint’ini çağırır.
Bu örnekler your-audio-model-id yer tutucusunu kullanır. Request’i çalıştırmadan önce bunu Models page ya da model directory içinden उपलब्ध bir audio model ID ile değiştirin.
Playground ve endpoint şemasını kullanmak için Create Speech sayfasını açın.
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)

Response example

Başarılı bir speech response’u ikili audio’dur. HTTP response’u şöyle görünebilir:
HTTP/1.1 200 OK
Content-Type: audio/mpeg

speech.mp3

Örnek model kayıtları

Bu örnek model katalog response’u, /api/models zarfını ve bir audio model kaydı yapısını gösterir. Bu, tam bir model listesi değildir.
cURL
curl https://api.cometapi.com/api/models
{
  "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

Endpoint sayfasında belgelenen formatları kullanın.
Audio dosyasını sıkıştırın veya işi daha küçük dosyalara bölün.
Dosyanın speech içerdiğini ve alan adının dokümantasyonla eşleştiğini doğrulayın.
https://api.cometapi.com/v1 kullanın.

Hata kodları ve retry stratejisi

Metin, dosya, model ID, voice veya format düzeltilene kadar retry yapmayın.
API key mevcut ve geçerli olana kadar retry yapmayın.
Retry etmeden önce base URL, path ve model ID’yi kontrol edin.
Retry etmeden önce upload boyutunu azaltın.
Exponential backoff ile retry edin ve concurrency’yi azaltın.
Geçici provider veya service hataları için backoff ile retry edin.
Uygulama kalıpları için Error codes and retry strategy ve Rate limits and concurrency sayfalarına bakın.

Fiyatlandırma ve model dizini

Models page

CometAPI’nin dokümantasyonda model ID’lerini nasıl sunduğunu okuyun.

Model directory

Model erişilebilirliğini ve yeteneklerini inceleyin.

Pricing

Bir modeli çağırmadan önce fiyatlandırmayı kontrol edin.
Last modified on May 28, 2026