Audio APIs

Sử dụng tài liệu về model âm thanh của CometAPI bằng cách chọn xem ứng dụng của bạn cần đầu ra giọng nói, phiên âm hay dịch thuật. Các endpoint âm thanh dùng cùng mẫu API key CometAPI như các endpoint tương thích OpenAI khác.

Chọn một audio API

Tạo giọng nói

Chuyển văn bản thành giọng nói.

Tạo bản phiên âm

Phiên âm âm thanh thành văn bản.

Tạo bản dịch

Dịch âm thanh sang văn bản tiếng Anh.

Create speech

Sử dụng một model ID có khả năng xử lý âm thanh từ trang Models hoặc thư mục model. Các ví dụ bên dưới gọi endpoint speech.

Các ví dụ này sử dụng giá trị giữ chỗ your-audio-model-id. Hãy thay thế nó bằng một model ID âm thanh khả dụng từ trang Models hoặc thư mục model trước khi bạn chạy request.

Mở Create speech để sử dụng playground và schema của 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

Ví dụ phản hồi

Một phản hồi speech thành công là dữ liệu âm thanh nhị phân. Phản hồi HTTP có thể trông như sau:

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

speech.mp3

Bản ghi model ví dụ

Phản hồi danh mục model ví dụ này hiển thị lớp bao /api/models và hình dạng của một bản ghi model âm thanh. Đây không phải là danh sách model đầy đủ.

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

Các lỗi thường gặp

Định dạng âm thanh không được hỗ trợ

Sử dụng các định dạng được ghi trong tài liệu trên trang endpoint.

Tải lên dung lượng lớn bị từ chối

Nén tệp âm thanh hoặc chia tác vụ thành các tệp nhỏ hơn.

Bản chép lời trống

Xác nhận rằng tệp có chứa giọng nói và tên trường khớp với tài liệu.

Base URL sai

Sử dụng https://api.cometapi.com/v1.

Mã lỗi và chiến lược retry

400

Không retry cho đến khi văn bản, tệp, model ID, giọng nói hoặc định dạng được sửa đúng.

401

Không retry cho đến khi API key đã có và hợp lệ.

404

Kiểm tra base URL, đường dẫn và model ID trước khi retry.

413

Giảm kích thước tải lên trước khi retry.

429

Retry với exponential backoff và giảm mức độ đồng thời.

500 or 503

Retry với backoff cho các lỗi tạm thời từ provider hoặc dịch vụ.

Để xem các mẫu triển khai, hãy xem Mã lỗi và chiến lược retry và Giới hạn tốc độ và mức độ đồng thời.

Giá và danh mục model

Trang models

Đọc cách CometAPI hiển thị model ID trong tài liệu.

Danh mục model

Xem tình trạng khả dụng và năng lực của model.

Giá

Kiểm tra giá trước khi bạn gọi model.

Kiểm duyệt nội dung

Khóa API

Chọn một audio API

Tạo giọng nói

Tạo bản phiên âm

Tạo bản dịch

Create speech

Ví dụ phản hồi

Bản ghi model ví dụ

Các lỗi thường gặp

Mã lỗi và chiến lược retry

Giá và danh mục model

Trang models

Danh mục model

Giá

​Chọn một audio API

Tạo giọng nói

Tạo bản phiên âm

Tạo bản dịch

​Create speech

​Ví dụ phản hồi

​Bản ghi model ví dụ

​Các lỗi thường gặp

​Mã lỗi và chiến lược retry

​Giá và danh mục model

Trang models

Danh mục model

Giá

Chọn một audio API

Create speech

Ví dụ phản hồi

Bản ghi model ví dụ

Các lỗi thường gặp

Mã lỗi và chiến lược retry

Giá và danh mục model