OpenAPI Penagihan dan Kesalahan

Halaman ini berlaku untuk /api/v1/data/*, API eksklusif platform OpenAPI Felo. Panggilan menggunakan saldo platform, saldo kredit layanan dalam denominasi USD. Ini tidak mengonsumsi kredit Felo Pro. Felo APIs yang lebih lama di bawah /v2 menggunakan kredit Pro.

Baca harga terkini

curl -sS https://openapi.felo.ai/api/v1/data/prices

Endpoint publik ini tidak memerlukan kunci. Cocokkan entri berdasarkan ID operasi dan baca tarif serta unit penagihan saat ini; jangan mengasumsikan setiap operasi berbiaya sama atau membekukan tarif dari contoh ke aplikasi Anda.

Kueri status gratis tidak membuat pembuatan atau ekspor yang mendasarinya menjadi gratis. Untuk X, paginasi dan rekaman bersarang yang dikembalikan dapat meningkatkan penggunaan yang ditagihkan.

Saldo dan reservasi

Sebelum eksekusi, layanan dapat mencadangkan saldo yang cukup untuk operasi tersebut. Pekerjaan yang sukses diselesaikan terhadap cadangan itu; kegagalan yang dikonfirmasi melepaskannya. Untuk tugas asinkron, mengembalikan ID tidak berarti penagihan sudah final.

Harga halaman PPT mencadangkan sepuluh halaman saat pembuatan. Pembuatan yang sukses menyelesaikan output aktual dan melepaskan dana yang tidak terpakai. Pembuatan dan ekspor adalah biaya yang terpisah. Lihat alur kerja PPT untuk perilaku ekspor berulang.

Jika eksekusi atau penyelesaian tidak pasti, reservasi dapat tetap tertunda saat layanan merekonsiliasinya. Jangan perlakukan setiap timeout atau 5xx sebagai bukti bahwa tidak ada pekerjaan yang terjadi atau bahwa permintaan berulang itu gratis.

Tinjau saldo tersedia dan penggunaan Anda di Console Billing. Untuk panduan isi ulang di tingkat akun, lihat Billing and Credits.

Periksa penggunaan wallet melalui API

Pemilik akun dapat memeriksa catatan panggilan wallet menggunakan Felo login token. Kredensial ini berbeda dari API Key yang digunakan untuk panggilan Data API; jangan menggantikan FELO_API_KEY.

curl -sS 'https://openapi.felo.ai/api/wallet/usage?call_type=data' \
  -H 'Authorization: Bearer YOUR_FELO_LOGIN_TOKEN'

Catatan berada di bawah data.items; call_type=data memfilter panggilan kapabilitas. Bandingkan penggunaan dengan harga saat ini pada akun. Membaca catatan tidak mengirim tugas pembuatan lain. Console Billing tetap tersedia untuk peninjauan dan isi ulang akun.

Baca kesalahan secara defensif

Periksa status HTTP terlebih dahulu. Kesalahan dapat menggunakan salah satu dari bentuk ini; nilai di bawah bersifat ilustratif:

{"error":{"code":"invalid_parameter","message":"Check the request fields"},"request_id":"example-request-id"}

{"status":402,"code":"INSUFFICIENT_BALANCE","message":"Insufficient balance","request_id":"example-request-id"}

Baca error.code / error.message jika ada, jika tidak code / message. Pertahankan request_id jika dikembalikan. Respons sukses bervariasi menurut operasi; jangan paksa semuanya ke dalam pembungkus error atau data yang sama.

Putuskan tindakan berikutnya

execution_unconfirmed (409) dan billing_settlement_pending (503) memerlukan perhatian khusus: jangan langsung mengirim ulang pekerjaan berbayar. Kueri tugas yang diketahui atau hubungi dukungan dengan request ID. Status HTTP sukses dengan hasil kosong berbeda dari respons kesalahan.

Retry tanpa membuat pekerjaan duplikat

• Untuk kueri tugas dan status ekspor yang hanya baca, gunakan backoff terbatas dan hormati Retry-After bila ada.
• Untuk permintaan create yang gagal dengan task_id tersimpan, kueri tugas itu sebelum membuat yang lain.
• Jika koneksi gagal sebelum Anda menerima ID, hasilnya mungkin tidak diketahui. Jangan mengasumsikan bahwa mengirim ulang akan menduplikasi permintaan.
• Untuk 429, bedakan batas laju singkat dari jendela kuota API key; retry berulang tidak dapat mereset kuota.
• Hentikan retry setelah tenggat yang dikonfigurasi dan tampilkan kesalahan yang dapat ditindaklanjuti kepada pemanggil.

Untuk dukungan, berikan endpoint, waktu perkiraan, status HTTP, dan request ID. Jangan pernah menyertakan API key penuh.