Lewati ke konten

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.

GET /api/v1/billing/credits/balance
Terminal window
curl https://omnidoc.top/api/v1/billing/credits/balance \
-H "X-API-Key: $OMNIDOC_API_KEY"

Bidang utama:

BidangArti
availableMillicredit tersedia sekarang, setelah utang; negatif saat berutang
debtUtang 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
spentTotal millicredit yang diselesaikan
expiredMillicredit yang kedaluwarsa atau ditarik kembali
today_chargedMillicredit telah diselesaikan hari ini
lotsLot kredit yang saat ini masih berlaku dan masa berlakunya
GET /api/v1/billing/credits/plans

Endpoint publik yang tidak memerlukan login dan mengembalikan paket yang sedang dijual (purchase_plans, berdasarkan kode paket). Sekarang sedang dijual:

Kode rencanaKreditHargaBonus
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (direkomendasikan)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • “Bonus” dihitung berdasarkan harga 10.000 kredit sebesar ¥29,90 dan merupakan bidang bonus_percent; paket yang direkomendasikan memiliki recommended: true. Kedua bidang tersebut tidak muncul jika tidak ditetapkan.
  • price_fen (dalam fen, 1/100 yuan) merupakan satuan harga yang berlaku, sedangkan total_millicredits (millicredit) untuk kredit. Kredit yang dibeli tidak akan kedaluwarsa; paket dapat dibeli kembali dan akan tiba sekaligus setiap kali pembelian.
  1. 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 dengan quota_exceeded=true, pekerjaan media berakhir dengan error_code=insufficient_credits) dan tidak ada biaya yang dibebankan. Memulai pekerjaan tidak mengubah saldo.
  2. 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.
  3. 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.

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

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

Endpoint penggunaan mengembalikan jumlah file, karakter, token, dan waktu pemrosesan akun.

Memeriksa saldo, status pekerjaan, penggunaan, catatan penyelesaian, daftar hasil, dan alamat unduhan tidak dikenakan biaya kredit.