Ses API'leri

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

Create speech

Metni konuşmaya dönüştürün.

Create transcription

Sesi metne dönüştürün.

Create translation

Sesi İngilizce metne çevirin.

Create speech

Models sayfasından veya model dizininden ses destekli bir model ID kullanın. Aşağıdaki örnekler konuşma endpoint’ini çağırır.

Bu örneklerde your-audio-model-id yer tutucusu kullanılır. İsteği çalıştırmadan önce bunu Models sayfasından veya model dizininden kullanılabilir bir ses model ID ile değiştirin.

Playground’u 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)

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);

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

Yanıt örneği

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

HTTP/1.1 200 OK
Content-Type: audio/mpeg

speech.mp3

Örnek model kayıtları

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.

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

Desteklenmeyen ses formatı

Endpoint sayfasında belgelenen formatları kullanın.

Büyük yükleme reddedildi

Ses dosyasını sıkıştırın veya işi daha küçük dosyalara bölün.

Boş transkripsiyon

Dosyanın konuşma içerdiğini ve alan adının dokümanlarla eşleştiğini doğrulayın.

Yanlış base URL

https://api.cometapi.com/v1 kullanın.

Hata kodları ve yeniden deneme stratejisi

400

Metin, dosya, model ID, voice veya format düzeltilene kadar yeniden denemeyin.

401

API anahtarı mevcut ve geçerli olana kadar yeniden denemeyin.

404

Yeniden denemeden önce base URL, path ve model ID değerlerini kontrol edin.

413

Yeniden denemeden önce yükleme boyutunu azaltın.

429

Üstel backoff ile yeniden deneyin ve eşzamanlılığı azaltın.

500 or 503

Geçici provider veya servis hataları için backoff ile yeniden deneyin.

Uygulama kalıpları için Hata kodları ve yeniden deneme stratejisi ve Hız limitleri ve eşzamanlılık bölümlerine bakın.

Fiyatlandırma ve model dizini

Models sayfası

CometAPI’nin dokümanlarda model ID değerlerini nasıl sunduğunu öğrenin.

Model dizini

Model kullanılabilirliğine ve yeteneklerine göz atın.

Fiyatlandırma

Bir modeli çağırmadan önce fiyatlandırmayı kontrol edin.

İçerik moderasyonu

API anahtarları

Bir ses API’si seçin

Create speech

Create transcription

Create translation

Create speech

Yanıt örneği

Örnek model kayıtları

Yaygın hatalar

Hata kodları ve yeniden deneme stratejisi

Fiyatlandırma ve model dizini

Models sayfası

Model dizini

Fiyatlandırma

​Bir ses API’si seçin

Create speech

Create transcription

Create translation

​Create speech

​Yanıt örneği

​Örnek model kayıtları

​Yaygın hatalar

​Hata kodları ve yeniden deneme stratejisi

​Fiyatlandırma ve model dizini

Models sayfası

Model dizini

Fiyatlandırma

Bir ses API’si seçin

Create speech

Yanıt örneği

Örnek model kayıtları

Yaygın hatalar

Hata kodları ve yeniden deneme stratejisi

Fiyatlandırma ve model dizini