Kredit dan penggunaan
Layanan yang dapat ditagihkan diselesaikan dalam bentuk kredit akun. Jumlah diberikan dalam milikredit (millicredits); 1000 milikredit setara dengan 1 kredit. Jumlah yang Anda kirimkan dalam permintaan harus berupa bilangan bulat; jumlah dalam saldo dan catatan dapat memiliki satu angka desimal (0,1 milikredit). credit_precision dalam respons adalah 4, yang berarti paling banyak 4 angka desimal setelah dikonversi ke kredit.
Periksa saldo
Section titled “Periksa saldo”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Bidang utama:
| Bidang | Arti |
|---|---|
available | Millicredit tersedia sekarang, setelah utang; negatif saat berutang |
debt | Utang dalam milikredit: bagian dari biaya aktual pekerjaan yang telah selesai yang melebihi saldo. Kredit yang diterima kemudian (penambahan saldo, hibah harian, kode penukaran, pengembalian dana, dan sebagainya) akan melunasi utang terlebih dahulu |
spent | Total millicredit yang diselesaikan |
expired | Millicredit yang kedaluwarsa atau ditarik kembali |
today_charged | Millicredit telah diselesaikan hari ini |
lots | Lot kredit yang saat ini masih berlaku dan masa berlakunya |
Paket kredit
Section titled “Paket kredit”GET /api/v1/billing/credits/plansEndpoint publik yang tidak memerlukan login dan mengembalikan paket yang sedang dijual (purchase_plans, berdasarkan kode paket). Sekarang sedang dijual:
| Kode rencana | Kredit | Harga | Bonus |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4 (direkomendasikan) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- “Bonus” dihitung berdasarkan harga 10.000 kredit sebesar ¥29,90 dan merupakan bidang
bonus_percent; paket yang direkomendasikan memilikirecommended: true. Kedua bidang tersebut tidak muncul jika tidak ditetapkan. price_fen(dalam fen, 1/100 yuan) merupakan satuan harga yang berlaku, sedangkantotal_millicredits(millicredit) untuk kredit. Kredit yang dibeli tidak akan kedaluwarsa; paket dapat dibeli kembali dan akan tiba sekaligus setiap kali pembelian.
Siklus pengisian daya
Section titled “Siklus pengisian daya”- Saldo diperiksa terhadap ambang batas sebelum pekerjaan dimulai : saldo (setelah utang) harus berada di atas ambang batas pekerjaan, misalnya “halaman × 2 kredit” untuk terjemahan PDF, panjang teks sumber untuk file lain (minimal 2 kredit), dan untuk audio, video, serta ucapan, biaya dihitung dari durasi atau karakter yang diukur oleh server (harga dalam audio, video, dan suara ). Dengan kunci API yang memiliki anggaran, sisa anggaran kunci juga harus berada di atas ambang batas. Jika tidak, responsnya adalah
402(pekerjaan terjemahan file berakhir sebagai gagal denganquota_exceeded=true, pekerjaan media berakhir denganerror_code=insufficient_credits) dan tidak ada biaya yang dibebankan. Memulai pekerjaan tidak mengubah saldo. - Penggunaan aktual dikenakan biaya saat selesai : terjemahan file (termasuk gambar), teks kaya berkelompok, operasi dokumen, audio, video, dan ucapan dikenakan biaya penuh berdasarkan penggunaan aktual setelah selesai. Anggaran sebuah kunci API hanya digunakan untuk pemeriksaan sebelum dimulai dan tidak pernah mengurangi biaya untuk pekerjaan yang telah selesai; jika hal itu menyebabkan anggaran terpakai kunci melebihi batasnya, kunci tersebut tidak dapat memulai pekerjaan baru hingga batasnya dinaikkan. Pekerjaan yang gagal atau dibatalkan tidak dikenakan biaya.
- Saldo dapat menjadi negatif : bagian dari biaya aktual yang melebihi saldo dicatat sebagai utang dan saldo ditampilkan sebagai negatif; kredit yang masuk kemudian akan melunasi utang terlebih dahulu. Pekerjaan baru tidak dapat dimulai selama saldo negatif; tambahkan dana.
Klien tidak pernah mengajukan pertanyaan “berapa biaya yang harus dibebankan”; server menghitung jumlah yang telah diselesaikan berdasarkan apa yang telah diserahkan.
Operasi dan catatan
Section titled “Operasi dan catatan”GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}Sebuah rekaman berisi ID operasi, status, basis penagihan, serta jumlah yang ditagihkan dan dikembalikan. Dengan kunci API tertentu, hanya operasi yang dimulai oleh kunci tersebut yang akan terdaftar.
Penggunaan
Section titled “Penggunaan”GET /api/v1/usage?limit=50GET /api/v1/usage/summaryEndpoint penggunaan mengembalikan jumlah file, karakter, token, dan waktu pemrosesan akun.
Kueri tidak dipungut biaya
Section titled “Kueri tidak dipungut biaya”Memeriksa saldo, status pekerjaan, penggunaan, catatan penyelesaian, daftar hasil, dan alamat unduhan tidak dikenakan biaya kredit.