Tín dụng và cách sử dụng
Các dịch vụ tính phí được thanh toán dưới dạng tín dụng tài khoản. Số tiền được tính bằng millicredit (millicredits); 1000 millicredit tương đương với 1 tín dụng. Các số tiền bạn gửi trong yêu cầu phải là số nguyên; số tiền trong số dư và hồ sơ có thể có một chữ số thập phân (0,1 millicredit). credit_precision trong phản hồi là 4, nghĩa là tối đa 4 chữ số thập phân sau khi quy đổi sang tín dụng.
Kiểm tra số dư
Phần tiêu đề “Kiểm tra số dư”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Các trường chính:
| Trường | Ý nghĩa |
|---|---|
available | Millicredit hiện có, sau khi trừ nợ; âm khi đang nợ |
debt | Nợ tính bằng millicredit: phần chi phí thực tế của các công việc đã hoàn thành vượt quá số dư. Các khoản tín dụng đến sau (nạp thêm, trợ cấp hàng ngày, mã đổi thưởng, hoàn tiền, v.v.) sẽ được dùng để thanh toán nợ trước tiên. |
spent | Tổng millicredit đã thanh toán |
expired | Millicredit đã hết hạn hoặc bị thu hồi |
today_charged | Millicredits đã được thanh toán hôm nay |
lots | Số lượng tín dụng hiện đang hợp lệ và thời hạn hết hạn của chúng |
Gói tín dụng
Phần tiêu đề “Gói tín dụng”GET /api/v1/billing/credits/plansMột điểm cuối công khai không yêu cầu đăng nhập và trả về các gói đang khuyến mãi (purchase_plans, được khóa bởi mã gói). Đang khuyến mãi:
| Mã kế hoạch | Tín dụng | Giá | Tiền thưởng |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4 (được khuyến nghị) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- “Bonus” được tính dựa trên giá 10.000 điểm tín dụng là ¥29,90 và là trường
bonus_percent; gói khuyến nghị córecommended: true. Cả hai trường đều không hiển thị khi chưa được thiết lập. price_fen(tính bằng phân, 1/100 nguyên) là đơn vị giá trị chính thức, còntotal_millicredits(mili tín dụng) dùng để chỉ tín dụng. Tín dụng mua về không hết hạn; các gói có thể được mua lại và mỗi lần đều được giao trọn gói.
Vòng đời sạc
Phần tiêu đề “Vòng đời sạc”- Số dư được kiểm tra so với ngưỡng trước khi một công việc bắt đầu : số dư (sau khi trừ nợ) phải lớn hơn ngưỡng của công việc, ví dụ “số trang × 2 tín chỉ” đối với dịch thuật PDF, độ dài văn bản nguồn cho các tệp khác (ít nhất 2 tín chỉ), và đối với âm thanh, video và giọng nói, chi phí được tính dựa trên thời lượng hoặc số ký tự mà máy chủ đo đạc (giá cả theo âm thanh, video và giọng nói ). Với một khóa API có ngân sách, ngân sách còn lại của khóa cũng phải lớn hơn ngưỡng. Nếu không, phản hồi là
402(một công việc dịch tệp kết thúc thất bại vớiquota_exceeded=true, một công việc phương tiện kết thúc vớierror_code=insufficient_credits) và sẽ không bị tính phí. Việc bắt đầu một công việc không làm thay đổi số dư. - Việc tính phí theo mức sử dụng thực tế được áp dụng khi tác vụ hoàn tất : dịch tệp (bao gồm hình ảnh), văn bản có định dạng hàng loạt, thao tác tài liệu, âm thanh, video và giọng nói đều được tính phí đầy đủ theo mức sử dụng thực tế khi hoàn tất. Ngân sách của một khóa API chỉ được dùng để kiểm tra trước khi bắt đầu và không bao giờ làm giảm số tiền đã tính cho một tác vụ đã hoàn tất; nếu điều đó khiến ngân sách đã sử dụng của khóa vượt quá giới hạn, khóa sẽ không thể bắt đầu các tác vụ mới cho đến khi giới hạn được nâng lên. Các tác vụ thất bại hoặc bị hủy sẽ không bị tính phí.
- Số dư có thể âm : phần chi phí thực tế vượt quá số dư đượ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ông việc mới khi số dư âm; hãy nạp thêm tiền.
Khách hàng không bao giờ gửi yêu cầu “phải tính phí bao nhiêu”; máy chủ tự tính toán số tiền cuối cùng dựa trên những gì đã được cung cấp.
Các thao tác và bản ghi
Phần tiêu đề “Các thao tác và bản ghi”GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}Một bản ghi chứa ID thao tác, trạng thái, cơ sở tính phí, cũng như số tiền đã tính và đã hoàn. Khi được liệt kê cùng với một khóa API, các thao tác chỉ bao gồm những thao tác được khởi tạo bằng khóa đó.
Cách sử dụng
Phần tiêu đề “Cách sử dụng”GET /api/v1/usage?limit=50GET /api/v1/usage/summaryCác điểm cuối sử dụng trả về số lượng tệp, ký tự, token và thời gian xử lý của tài khoản.
Các truy vấn là miễn phí
Phần tiêu đề “Các truy vấn là miễn phí”Việc kiểm tra số dư, trạng thái công việc, mức sử dụng, hồ sơ thanh toán, danh sách kết quả và địa chỉ tải xuống không tốn tín dụng.