Lewati ke konten

Audio, video, dan suara

Pekerjaan media berjalan segera setelah dibuat dan dikenakan biaya berdasarkan harga kredit sesuai dengan penggunaan yang diukur oleh server. Baca katalog terlebih dahulu; hanya produk yang ditandai sebagai terbuka yang dapat dijalankan.

Harga diberikan langsung dalam kredit:

ProdukproductHarga
Pengenalan suaraasr20 kredit/menit; model waktu nyata fun-asr 30 kredit/menit (dibebankan per milidetik)
Terjemahan subjudulsubtitle_translation60 kredit/menit
Pemrosesan video dasar (subtitle terjemahan, audio asli)basic_video80 kredit/menit
Pemrosesan video lengkap (subtitle terjemahan dan sulih suara)full_video300 kredit/menit
Sintesis ucapantts1.500 kredit per 10.000 karakter yang ditagihkan
Penggunaan suara yang berhasil pertama kali—300 kredit per suara, dikenakan sekali saja
  • Harga pengenalan ucapan ditentukan oleh model pengenalan yang digunakan; harga kedua model tersebut tercantum secara terpisah dalam prices dari credit-catalog (bidang model).
  • Durasi dihitung dalam milidetik: pengenalan ucapan dan penerjemahan subtitle berdasarkan durasi sumber, sedangkan video berdasarkan durasi video yang disampaikan.
  • Karakter yang ditagihkan untuk sintesis ucapan: setiap karakter Tionghoa dihitung sebagai 2, sedangkan karakter lainnya (termasuk spasi dan tanda baca) dihitung sebagai 1.
  • Pengenalan, penerjemahan, sulih suara, dan langkah-langkah lain yang dibutuhkan oleh suatu produk sudah termasuk dalam harganya. Jika permintaan memungkinkan hasil tingkat lebih rendah (allowed_fallback_products) dan hasil tersebut disampaikan, maka harga untuk produk yang disampaikanlah yang berlaku.
  • Biaya = harga satuan × penggunaan, dibulatkan ke 0,001 kredit (1 milikredit).
GET /api/v1/billing/media/credit-catalog
POST /api/v1/billing/media/credit-estimates

credit-catalog mengembalikan harga setiap produk (prices, dalam milikredit) serta status keterbukaannya; credit-estimates menghitung kredit yang dibutuhkan (rounded_millicredits) untuk durasi, teks, atau jumlah suara tertentu. Fungsinya hanya untuk tampilan: tidak membuat pekerjaan apa pun dan tidak dikenakan biaya.

POST /api/v1/media-jobs
Idempotency-Key: unique-request-id

Produk:

productTujuan
asrPengenalan suara
ttsSintesis ucapan
subtitle_translationTerjemahan subtitle untuk audio dan video
basic_videoPemrosesan video dasar
full_videoPemrosesan video penuh

Contoh pengenalan ucapan:

{
"product": "asr",
"document_id": "4q8mx2q9z1k7p6ra",
"source_language": "auto",
"max_duration_ms": 600000
}

Setiap produk kecuali sintesis ucapan (tts) memerlukan max_duration_ms (milidetik, maksimal 21600000, yaitu 6 jam).

Setelah permintaan pembuatan mengembalikan 202, server memeriksa file dan mulai memproses:

  1. Hanya saldo yang diperiksa sebelum mulai : saldo (setelah utang) harus di atas biaya yang dihitung dari durasi yang diukur oleh server (untuk sintesis ucapan, dari karakter yang ditagihkan, termasuk biaya suara penggunaan pertama yang belum dibebankan); dengan kunci API yang memiliki anggaran, sisa anggaran pada kunci tersebut juga harus di atas biaya tersebut. Memulai tidak mengubah saldo.
  2. Penggunaan aktual dibebankan saat selesai : ditetapkan harga dan dibebankan berdasarkan produk yang dikirim serta penggunaannya. Apa pun yang tidak dicakup oleh saldo akan dicatat sebagai utang dan saldo akan menunjukkan nilai negatif; kredit yang masuk kemudian akan melunasi utang terlebih dahulu. Pekerjaan baru tidak dapat dimulai selama saldo masih negatif.
  3. Pekerjaan yang gagal atau dibatalkan tidak dikenakan biaya.

Ketika saldo terlalu rendah atau durasi tidak sesuai, tidak ada yang dimulai dan tidak ada biaya yang dikenakan: sintesis ucapan diperiksa saat pembuatan dan mengembalikan 402 ketika saldo terlalu rendah; produk lainnya diperiksa setelah server mengukur durasi, dan pekerjaan berakhir dengan status gagal bersama error_code insufficient_credits (saldo terlalu rendah) atau media_duration_exceeds_confirmed_cap (durasi sebenarnya melebihi max_duration_ms).

GET /api/v1/media-jobs/{operation_id}
GET /api/v1/media-jobs?limit=25
POST /api/v1/media-jobs/{operation_id}/cancel

Respons kueri mencakup status pekerjaan, file yang dikirim, dan referensi penyelesaian.

GET /api/v1/media-voices
POST /api/v1/media-voices
GET /api/v1/media-voices/{asset_id}
POST /api/v1/media-voices/{asset_id}/confirm
POST /api/v1/media-voices/{asset_id}/reconcile
POST /api/v1/media-voices/{asset_id}/revoke

reconcile memulihkan hasil jarak jauh yang tidak pasti; ia hanya memeriksa operasi asli dan tidak pernah membuat suara kedua.

Membuat suara memerlukan konfirmasi hak Anda atas rekaman tersebut:

{
"document_id": "authorized_recording_document_id",
"consent": true,
"consent_version": "voice-source-rights-v1"
}

Penelepon bertanggung jawab untuk memastikan bahwa rekaman tersebut merupakan miliknya sendiri atau digunakan dengan izin yang sah.