Âm thanh, video và giọng nói
Một tác vụ media sẽ chạy ngay khi được tạo và được tính phí theo giá tín dụng dựa trên mức sử dụng do máy chủ đo đạc. Vui lòng đọc danh mục trước; chỉ các sản phẩm được đánh dấu là mở mới có thể chạy.
Giá cả
Phần tiêu đề “Giá cả”Giá được tính trực tiếp bằng tín dụng:
| Sản phẩm | product | Giá |
|---|---|---|
| Nhận dạng giọng nói | asr | 20 tín chỉ/phút; mô hình thời gian thực fun-asr 30 tín chỉ/phút (tính phí theo mili giây) |
| Dịch tiêu đề phụ | subtitle_translation | 60 tín chỉ/phút |
| Xử lý video cơ bản (phụ đề dịch, âm thanh gốc) | basic_video | 80 tín chỉ/phút |
| Xử lý video đầy đủ (dịch phụ đề và lồng tiếng) | full_video | 300 điểm tín dụng/phút |
| Tổng hợp giọng nói | tts | 1.500 tín dụng cho mỗi 10.000 ký tự tính phí |
| Lần đầu tiên sử dụng giọng nói thành công | — | 300 tín dụng mỗi giọng nói, tính phí một lần |
- Giá nhận dạng giọng nói được tính theo mô hình nhận dạng được sử dụng; giá của cả hai mô hình đều được liệt kê riêng biệt trong
pricescủacredit-catalog(trườngmodel). - Thời lượng được tính bằng mili giây: nhận dạng giọng nói và dịch phụ đề dựa trên thời lượng nguồn, video dựa trên thời lượng video được cung cấp.
- Số ký tự tính phí cho tổng hợp giọng nói: mỗi ký tự Hán ngữ được tính là 2, mọi ký tự khác (bao gồm dấu cách và dấu câu) được tính là 1.
- Các bước như nhận dạng, dịch thuật, lồng tiếng và các công đoạn khác mà sản phẩm yêu cầu đều đã được bao gồm trong giá. Nếu yêu cầu cho phép kết quả ở cấp độ thấp hơn (
allowed_fallback_products) và kết quả đó được cung cấp, thì giá của sản phẩm đã được giao sẽ được áp dụng. - Chi phí = đơn giá × mức sử dụng, được làm tròn đến 0,001 tín dụng (1 mili-tín dụng).
GET /api/v1/billing/media/credit-catalogPOST /api/v1/billing/media/credit-estimatescredit-catalog trả về giá của từng sản phẩm (prices, tính bằng millicredit) và trạng thái mở hay đóng; credit-estimates tính toán số credit cần thiết (rounded_millicredits) cho một khoảng thời gian, văn bản hoặc số lượng giọng nói nhất định. Công cụ này chỉ dùng để hiển thị: nó không tạo tác vụ nào và không tính phí.
Tạo một công việc
Phần tiêu đề “Tạo một công việc”POST /api/v1/media-jobsIdempotency-Key: unique-request-idSản phẩm:
product | Mục đích |
|---|---|
asr | Nhận dạng giọng nói |
tts | Tổng hợp giọng nói |
subtitle_translation | Dịch phụ đề cho âm thanh và video |
basic_video | Xử lý video cơ bản |
full_video | Xử lý video đầy đủ |
Ví dụ về nhận dạng giọng nói:
{ "product": "asr", "document_id": "4q8mx2q9z1k7p6ra", "source_language": "auto", "max_duration_ms": 600000}Mọi sản phẩm, ngoại trừ tổng hợp giọng nói (tts), đều yêu cầu max_duration_ms (mili giây, tối đa 21600000, tương đương 6 giờ).
Sau khi yêu cầu tạo trả về 202, máy chủ kiểm tra tệp và bắt đầu xử lý:
- Chỉ kiểm tra số dư trước khi bắt đầu : số dư (sau khi trừ nợ) phải lớn hơn chi phí được tính từ khoảng thời gian máy chủ đã đo (đối với tổng hợp giọng nói, tính từ số ký tự đã tính phí, bao gồm cả phí giọng nói lần đầu sử dụng chưa được tính); nếu sử dụng khóa API có ngân sách, thì ngân sách còn lại của khóa cũng phải lớn hơn chi phí đó. Việc bắt đầu không làm thay đổi số dư.
- Việc sử dụng thực tế được tính phí khi hoàn tất : được định giá và tính phí dựa trên sản phẩm được giao và mức sử dụng. Bất kỳ khoản nào mà số dư không bao quát đều được ghi nhận là nợ và số dư hiển thị dưới dạng âm; các khoản tín dụng đến sau sẽ được dùng để thanh toán nợ trước. Không thể bắt đầu các công việc mới khi số dư đang ở mức âm.
- Các tác vụ thất bại hoặc bị hủy không bị tính phí.
Khi số dư quá thấp hoặc thời lượng không phù hợp, sẽ không có tác vụ nào được khởi tạo và cũng không có phí nào bị trừ: tổng hợp giọng nói được kiểm tra ngay khi tạo và trả về 402 nếu số dư quá thấp; các sản phẩm khác được kiểm tra sau khi máy chủ đo thời lượng, và tác vụ kết thúc với trạng thái thất bại kèm mã error_code insufficient_credits (số dư quá thấp) hoặc media_duration_exceeds_confirmed_cap (thời lượng thực tế vượt quá max_duration_ms).
Truy vấn và hủy
Phần tiêu đề “Truy vấn và hủy”GET /api/v1/media-jobs/{operation_id}GET /api/v1/media-jobs?limit=25POST /api/v1/media-jobs/{operation_id}/cancelPhản hồi truy vấn bao gồm trạng thái công việc, các tệp đã được giao và tham chiếu thanh toán.
Giọng nói
Phần tiêu đề “Giọng nói”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 khôi phục một kết quả từ xa không xác định; nó chỉ kiểm tra thao tác gốc và không bao giờ tạo ra một luồng xử lý thứ hai.
Để tạo giọng nói, bạn cần xác nhận quyền sở hữu đối với bản ghi âm:
{ "document_id": "authorized_recording_document_id", "consent": true, "consent_version": "voice-source-rights-v1"}Người gọi có trách nhiệm đảm bảo rằng bản ghi âm là của riêng họ hoặc được sử dụng với sự cho phép hợp lệ.