API audio

Gunakan dokumentasi model audio CometAPI dengan memilih apakah aplikasi Anda memerlukan output suara, transkripsi, atau terjemahan. Endpoint audio menggunakan pola API key CometAPI yang sama seperti endpoint lain yang kompatibel dengan OpenAI.

Pilih API audio

Create speech

Ubah teks menjadi ucapan.

Create transcription

Transkripsikan audio menjadi teks.

Create translation

Terjemahkan audio menjadi teks bahasa Inggris.

Create speech

Gunakan model ID yang mendukung audio dari halaman Models atau direktori model. Contoh di bawah ini memanggil endpoint speech.

Contoh ini menggunakan placeholder your-audio-model-id. Ganti dengan model ID audio yang tersedia dari halaman Models atau direktori model sebelum Anda menjalankan request.

Buka Create speech untuk menggunakan playground dan skema endpoint.

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

Contoh respons

Respons speech yang berhasil berupa audio biner. Respons HTTP dapat terlihat seperti ini:

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

speech.mp3

Contoh record model

Contoh respons katalog model ini menampilkan envelope /api/models dan bentuk satu record model audio. Ini bukan daftar model yang lengkap.

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
      }
    }
  ]
}

Kesalahan umum

Format audio tidak didukung

Gunakan format yang didokumentasikan di halaman endpoint.

Unggahan besar ditolak

Kompres file audio atau bagi pekerjaan menjadi file yang lebih kecil.

Transkripsi kosong

Pastikan file berisi ucapan dan nama field sesuai dengan dokumentasi.

Base URL salah

Gunakan https://api.cometapi.com/v1.

Kode error dan strategi retry

400

Jangan lakukan retry sampai text, file, model ID, voice, atau format diperbaiki.

401

Jangan lakukan retry sampai API key tersedia dan valid.

404

Periksa base URL, path, dan model ID sebelum melakukan retry.

413

Kurangi ukuran unggahan sebelum melakukan retry.

429

Lakukan retry dengan exponential backoff dan kurangi concurrency.

500 or 503

Lakukan retry dengan backoff untuk error provider atau layanan yang bersifat sementara.

Untuk pola implementasi, lihat Kode error dan strategi retry dan Rate limits dan concurrency.

Harga dan direktori model

Halaman model

Baca bagaimana CometAPI menampilkan model ID dalam dokumentasi.

Direktori model

Telusuri ketersediaan dan kapabilitas model.

Harga

Periksa harga sebelum Anda memanggil model.

Moderasi konten

Kunci API

Pilih API audio

Create speech

Create transcription

Create translation

Create speech

Contoh respons

Contoh record model

Kesalahan umum

Kode error dan strategi retry

Harga dan direktori model

Halaman model

Direktori model

Harga

​Pilih API audio

Create speech

Create transcription

Create translation

​Create speech

​Contoh respons

​Contoh record model

​Kesalahan umum

​Kode error dan strategi retry

​Harga dan direktori model

Halaman model

Direktori model

Harga

Pilih API audio

Create speech

Contoh respons

Contoh record model

Kesalahan umum

Kode error dan strategi retry

Harga dan direktori model