Bỏ qua để đến nội dung

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.

GET /api/v1/billing/credits/balance
Terminal window
curl 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
availableMillicredit hiện có, sau khi trừ nợ; âm khi đang nợ
debtNợ 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.
spentTổng millicredit đã thanh toán
expiredMillicredit đã hết hạn hoặc bị thu hồi
today_chargedMillicredits đã được thanh toán hôm nay
lotsSố 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
GET /api/v1/billing/credits/plans

Mộ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ạchTín dụngGiáTiền thưởng
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (được khuyến nghị)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • “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òn total_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.
  1. 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ới quota_exceeded=true, một công việc phương tiện kết thúc với error_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ư.
  2. 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í.
  3. 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.

GET /api/v1/billing/credits/operations?limit=20
GET /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 đó.

GET /api/v1/usage?limit=50
GET /api/v1/usage/summary

Cá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.

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.