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:
| Produk | product | Harga |
|---|---|---|
| Pengenalan suara | asr | 20 kredit/menit; model waktu nyata fun-asr 30 kredit/menit (dibebankan per milidetik) |
| Terjemahan subjudul | subtitle_translation | 60 kredit/menit |
| Pemrosesan video dasar (subtitle terjemahan, audio asli) | basic_video | 80 kredit/menit |
| Pemrosesan video lengkap (subtitle terjemahan dan sulih suara) | full_video | 300 kredit/menit |
| Sintesis ucapan | tts | 1.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
pricesdaricredit-catalog(bidangmodel). - 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-catalogPOST /api/v1/billing/media/credit-estimatescredit-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.
Buat pekerjaan
Section titled “Buat pekerjaan”POST /api/v1/media-jobsIdempotency-Key: unique-request-idProduk:
product | Tujuan |
|---|---|
asr | Pengenalan suara |
tts | Sintesis ucapan |
subtitle_translation | Terjemahan subtitle untuk audio dan video |
basic_video | Pemrosesan video dasar |
full_video | Pemrosesan 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:
- 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.
- 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.
- 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).
Kueri dan batalkan
Section titled “Kueri dan batalkan”GET /api/v1/media-jobs/{operation_id}GET /api/v1/media-jobs?limit=25POST /api/v1/media-jobs/{operation_id}/cancelRespons kueri mencakup status pekerjaan, file yang dikirim, dan referensi penyelesaian.
GET /api/v1/media-voicesPOST /api/v1/media-voicesGET /api/v1/media-voices/{asset_id}POST /api/v1/media-voices/{asset_id}/confirmPOST /api/v1/media-voices/{asset_id}/reconcilePOST /api/v1/media-voices/{asset_id}/revokereconcile 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.