Tài liệu
Thanh toán
Thanh toán theo mức sử dụng từ ví trả trước. Mỗi lệnh gọi được đo đến đơn vị micro-cent và ghi vào sổ cái bất biến. Không cần thuê bao, không cam kết, số dư không hết hạn.
Nạp tiền qua Stripe → số dư được lưu trong ví → chi phí của từng lệnh gọi API được trừ theo thời gian thực. Nếu số dư về 0, các lệnh gọi sẽ trả về 402 insufficient_quota cho đến khi bạn nạp tiền lại.
Để xem số dư bằng chương trình, hãy gọi GET /v1/balance. Endpoint trả về số dư ví, số tiền đang được tạm giữ cho các tác vụ vẫn đang chạy và phần còn lại của giới hạn hàng tháng; lệnh gọi này không mất phí. Xem Số dư.
Mô hình định giá
Với mỗi lệnh gọi, Kunavo tính chi phí người dùng bằng giá trị lớn hơn trong hai con số sau:
- Chi phí catalog — giá hiển thị trên thẻ mô hình (mỗi 1M token, mỗi ảnh, mỗi giây video, v.v.) × đơn vị sử dụng thực tế.
- Chi phí nhà cung cấp — khoản nhà cung cấp tính phí Kunavo cho lệnh gọi đó.
- Hệ số cộng giá — biên lợi nhuận của Kunavo trên chi phí đó.
Hàm max() đảm bảo rằng: (a) bạn không bao giờ trả ít hơn giá catalog đã công bố và (b) chúng tôi không lỗ khi chi phí nhà cung cấp tăng đột biến ngoài dự kiến cho một lệnh gọi.
Đơn vị tính phí theo từng phương thức
| Phương thức | Đơn vị | Độ chi tiết |
|---|---|---|
| Trò chuyện | mỗi 1M token đầu vào + mỗi 1M token đầu ra | Chính xác đến từng token; token suy luận được tính theo mức giá đầu ra. |
| Hình ảnh (t2i / chỉnh sửa) | mỗi ảnh | Mỗi ảnh được tạo; các lần tạo một phần không bị tính phí. |
| Video | mỗi video | Giá cố định cho mỗi đoạn clip, tùy theo mức độ phân giải. |
Các prompt dài được tính phí theo bậc ngữ cảnh dài của nhà cung cấp. Với GPT-5.5, GPT-5.6 Sol và Terra, và GPT-6 Astra, prompt dài hơn 272K token đầu vào sẽ tính phí toàn bộ yêu cầu ở mức 2× đầu vào — kể cả lượt đọc và ghi bộ nhớ đệm — và 1.5× đầu ra, theo bậc giá OpenAI công bố. Claude không phụ thu ngữ cảnh dài: ngữ cảnh 1M được tính theo giá tiêu chuẩn.
Token được lưu trong bộ nhớ đệm
Các mô hình chat lưu tiền tố prompt ổn định vào bộ nhớ đệm. Lượt đọc bộ nhớ đệm được tính phí thấp hơn nhiều so với mức đầu vào thông thường — 0.10× trên cả Claude lẫn OpenAI, và 0.025× ở Claude Fable 5.1, 0.05× ở Claude Opus 5.5. Lượt ghi bộ nhớ đệm được tính bằng 1.25× mức đầu vào trên mọi mô hình Claude, bao gồm cả lượt ghi có TTL 1 giờ (thấp hơn mức 2× của Anthropic), cũng như trên GPT-5.6 Sol, Terra và Luna, và GPT-6 Astra; với mọi mô hình khác, lượt ghi được tính theo mức đầu vào thông thường. Mỗi loại có mức chiết khấu riêng theo mô hình, vì vậy giá bộ nhớ đệm được giảm tương ứng với cùng mức chiết khấu so với giá niêm yết của nhà cung cấp như giá đầu vào và đầu ra. Mức sàn max() ở trên được tính có xét đến bộ nhớ đệm, nhờ đó bạn nhận được phần chiết khấu thay vì bị triệt tiêu bởi giá catalog.
Xem hướng dẫn bộ nhớ đệm prompt để biết đầy đủ bảng giá, cách bật cache_control và cách định tuyến affinity của Kunavo giúp duy trì bộ nhớ đệm ở trạng thái sẵn sàng.
Độ chính xác
Mọi khoản tiền trong Kunavo đều được lưu dưới dạng micro_cents:
1 USD = 100,000,000 micro_cents1 cent = 1,000,000 micro_cents- Mức phí nhỏ nhất có thể tính chính xác:
0.0001 cent($0.000001). Nhiều lệnh gọi chat trong thực tế được tính ở mức sàn này.
Bảng điều khiển làm tròn số nhỏ đến 6 chữ số thập phân (USD) và làm tròn còn 2 chữ số khi đạt mức cent. Kế toán nội bộ dùng giá trị chính xác.
Nạp tiền
Nạp tiền vào ví tại /app/billing thông qua Stripe Checkout: thẻ (Visa, Mastercard, Amex, JCB, UnionPay) ở mọi nơi Stripe hỗ trợ, cùng Apple Pay, Google Pay và Link ở mọi nơi ngoại trừ Ấn Độ. Các phương thức bị giới hạn theo quốc gia sẽ xuất hiện cho thị trường của người mua — tại Hoa Kỳ có Cash App Pay, Klarna, Afterpay, ghi nợ ngân hàng ACH (thanh toán trong 3–5 ngày làm việc) và tiền mã hóa (stablecoin), cùng Affirm cho các lần nạp từ $100 trở lên và Zip cho các lần nạp từ $100 đến $1.500; Alipay và WeChat Pay tại Trung Quốc đại lục; KakaoPay, Naver Pay, PAYCO, Samsung Pay và thẻ nội địa Hàn Quốc tại Hàn Quốc; UPI tại Ấn Độ; Pix tại Brazil; iDEAL tại Hà Lan, Bancontact tại Bỉ, EPS tại Áo, MB WAY tại Bồ Đào Nha và Satispay tại Ý; BLIK tại Ba Lan; Bacs Direct Debit tại Vương quốc Anh; và Pay by Bank cho người mua tại Vương quốc Anh, Ireland và Phần Lan.
Giá theo bậc
| Nạp tiền | Bạn nhận được | Thưởng |
|---|---|---|
| $10 | $10.00 | — |
| $100 | $110.00 | +$10 (10%) |
| $1.000 | $1.200,00 | +$200 (20%) |
| $5.000 | $6.250,00 | +$1.250 (25%) |
/app/keys để đặt mức trần cứng cho một tác vụ cụ thể: nếu một lệnh gọi sẽ khiến chi tiêu của khóa trong tháng dương lịch vượt quá mức bạn đặt, lệnh gọi đó sẽ bị từ chối với lỗi 402 insufficient_quota và không bị tính phí. Các khóa khác vẫn hoạt động. Bạn cũng có thể đặt danh sách IP cho phép cho từng khóa ngay tại màn hình này — các lệnh gọi từ địa chỉ khác sẽ nhận 403.Tự động nạp tiền
Tùy chọn. Lưu thẻ một lần tại /app/billing rồi đặt ba con số: số dư thấp hơn mức nào thì nạp tiền, số tiền nạp mỗi lần và mức trần hàng tháng. Sau đó, Kunavo sẽ nạp tiền vào ví từ thẻ này trong vài giây sau khi một khoản phí khiến số dư ở dưới ngưỡng, và cả khi số dư ví không đủ cho một yêu cầu; khi đó, Kunavo sẽ thử lại yêu cầu ấy thêm một lần trước khi phản hồi. Việc nạp tiền chỉ được thực hiện khi số dư (chưa trừ các khoản đang được tạm giữ cho những yêu cầu và tác vụ đang chạy) thấp hơn ngưỡng và việc nạp tiền vẫn nằm trong các giới hạn nạp tiền; nếu không có lần nạp nào hoặc số tiền nạp không đủ, yêu cầu sẽ bị từ chối, vì vậy bạn vẫn có thể nhận 402 ngay cả khi tính năng nạp tiền tự động đang bật.
| Cài đặt | Phạm vi | Ghi chú |
|---|---|---|
| Kích hoạt khi số dư xuống dưới | $5 – $1.000 | Đặt mức này cao hơn yêu cầu đơn lẻ lớn nhất của bạn. |
| Số tiền mỗi lần | $10 – $1.000, theo số đô la nguyên | $100 và $1.000 nhận cùng khoản thưởng như lần nạp thủ công, và một vài khoản nhỏ hơn cũng có khoản thưởng nhỏ riêng; các khoản khác không có thưởng. |
| Mức trần hàng tháng | số tiền nạp mỗi lần – $20.000 | Tính khoản phí bạn phải trả trong mỗi tháng dương lịch, không tính tiền thưởng. |
KUNAVO* AUTOTOPUP.Trong lúc chờ khoản nạp tiền được xử lý, yêu cầu bị từ chối sẽ nhận 402 kèm Retry-After: 3; các trường hợp từ chối khác đều nêu rõ bước tiếp theo cần thực hiện. Bạn có thể tắt tính năng hoặc thay đổi các con số bất cứ lúc nào trên cùng trang.
Thời điểm webhook
Sau khi hoàn tất Stripe Checkout, số dư được cập nhật qua webhook. Webhook thường được gửi trong vòng 5–10 giây sau khi xác nhận thanh toán. Thanh toán bằng thẻ gần như tức thì; phương thức chỉ xác nhận bất đồng bộ có thể mất vài ngày để quyết toán. Các đơn đó hiển thị trạng thái processing cho đến khi tiền được ghi nhận; khi ấy, webhook quyết toán sẽ cộng tiền vào ví — bạn không cần thanh toán lại và không có gì hết hạn trong thời gian chờ. Đơn hàng chưa bao giờ hoàn tất sẽ hiển thị trạng thái pending; tác vụ dọn dẹp của chúng tôi sẽ đổi nhãn thành expired sau 24 giờ. Nhãn này chỉ mang tính hiển thị và không hủy bất cứ thứ gì.
Sổ cái tín dụng
Mọi thay đổi số dư đều được ghi vào sổ cái chỉ ghi thêm:
| Loại | Hướng | Khi |
|---|---|---|
| topup | ghi có (+) | Đã xác nhận thanh toán Stripe. |
| consume | ghi nợ (−) | Lệnh gọi API được tính phí khi hoàn tất. |
| refund | ghi nợ (−) | Số dư đã trả tiền được hoàn về phương thức thanh toán của bạn, và khoản thưởng đi kèm số dư đó cũng bị trừ khỏi ví theo. |
| manual_ | ghi có/ghi nợ (+/−) | Điều chỉnh của nhân viên vận hành (ví dụ: ghi có sau một sự cố). |
Mỗi hàng được đóng dấu balance_after_micro_cents để cung cấp ảnh chụp trạng thái theo từng sự kiện. Xem toàn bộ lịch sử tại /app/billing.
Nhật ký sử dụng
Mỗi lệnh gọi API được ghi thành một dòng trong usage_logs:
- Mô hình, trạng thái (thành công / lỗi), mã trạng thái HTTP
- Token đầu vào / đầu ra, token đã có trong bộ nhớ đệm + token ghi vào bộ nhớ đệm, số lượng hình ảnh, số giây, số ký tự
cost_micro_cents— khoản bạn đã trả- Độ trễ, IP yêu cầu, tác nhân người dùng, tiền tố khóa API
Có thể xem tại /app/usage với bộ lọc và trang chi tiết cho từng lệnh gọi.
Các lệnh gọi thất bại có mất phí không?
Không. Kunavo chỉ tính phí khi status = success. Nếu nhà cung cấp thượng nguồn trả về lỗi 4xx / 5xx hoặc tác vụ của chúng tôi hết thời gian chờ, lệnh gọi vẫn được ghi lại nhưng chi phí là $0. Chúng tôi tự chịu chi phí từ nhà cung cấp thượng nguồn thay vì chuyển khoản đó cho bạn.
Hoàn tiền
Số dư chưa sử dụng mà bạn đã trả tiền có thể được hoàn bất cứ lúc nào, không cần đóng tài khoản, về phương thức thanh toán bạn đã dùng, sau khi trừ phí xử lý của Stripe theo tỷ lệ số tiền được hoàn. Số dư đã dùng cho các lệnh gọi API, cũng như tín dụng thưởng hoặc khuyến mãi, không được hoàn lại.
Yêu cầu hoàn tiền tại Thanh toán → Hoàn số dư chưa dùng, hoặc gửi email đến contact@kunavo.com. Yêu cầu được xử lý trong vòng 5 ngày làm việc. Nếu thời hạn hoàn tiền của một phương thức thanh toán địa phương đã qua, phần tiền hoàn lẽ ra trả về phương thức đó sẽ vẫn nằm trong ví của bạn và chúng tôi sẽ liên hệ để thu xếp cách khác. Quy định đầy đủ có trong Chính sách hoàn tiền.
Khoản phí chúng tôi tính nhầm, chẳng hạn do lỗi định giá, sẽ được hoàn lại toàn bộ, bao gồm cả phí xử lý.