Memahami URL Dasar
URL dasar menentukan tempat klien Anda mengirim permintaan. Ketidakcocokan di sini menyebabkan kegagalan koneksi segera atau respons model yang tidak terduga. Banyak pengembang mengasumsikan URL OpenAI standar berfungsi secara universal, tetapi penyedia tanpa sensor sering menggunakan endpoint berbeda untuk mengarahkan lalu lintas ke kumpulan model tertentu.
Verifikasi bahwa konfigurasi Anda mengarah ke https://api.openrouterabliteratedmodels.com/v1 untuk layanan kami. Jika Anda menggunakan agregator pihak ketiga, pastikan URL dasar sesuai dengan dokumentasi mereka secara tepat. URL yang salah sering kali menghasilkan kesalahan 404 atau respons dari model default alih-alih varian tak sensor yang dimaksud.
- Periksa variabel lingkungan Anda untuk
BASE_URLatauAPI_HOST. - Pastikan jalur termasuk
/v1untuk kompatibilitas standar. - Uji konektivitas dengan permintaan daftar model sederhana sebelum penggunaan berat.
Menangani Batas Kecepatan
Batas laju membatasi jumlah permintaan yang dapat Anda kirimkan dalam jangka waktu tertentu. API kami menerapkan batas 300 permintaan per menit per kunci. Melebihi batas ini akan menghasilkan kesalahan HTTP 429, yang secara sementara memblokir permintaan lebih lanjut hingga jendela waktu direset.
Selain itu, ada batas permintaan konkuren sebesar 8 permintaan secara bersamaan per kunci. Jika Anda mengirim lebih dari 8 permintaan simultan, kelebihan akan antri atau gagal tergantung pada pustaka klien Anda. Pantau konkurensi aplikasi Anda untuk menghindari batas keras ini. Gunakan strategi backoff eksponensial dalam kode Anda untuk menangani kesalahan 429 dengan lancar tanpa membanjiri server.
Ingat bahwa setiap kunci unik untuk akun Anda. Berbagi kunci di seluruh beberapa layanan dapat mempercepat mencapai batas ini. Hasilkan kunci baru jika Anda memerlukan kumpulan batas lahu terpisah untuk bagian aplikasi yang berbeda.
Respons Streaming vs Non-Streaming
Streaming mengembalikan data secara bertahap saat token dihasilkan, sementara non-streaming menunggu respons penuh. Streaming sangat penting untuk pengalaman pengguna waktu nyata tetapi memerlukan penanganan Server-Sent Events (SSE) yang cermat.
Saat streaming, potongan terakhir berisi statistik penggunaan token. Jika Anda menghentikan pemrosesan lebih awal, Anda mungkin kehilangan data ini. Pastikan klien Anda mengurai pesan SSE terakhir untuk mengambil jumlah token input dan output secara akurat. Respons non-streaming lebih sederhana tetapi dapat menyebabkan latensi tinggi untuk output panjang.
Pilih streaming untuk antarmuka obrolan di mana pengguna melihat teks muncul karakter demi karakter. Gunakan non-streaming untuk pemrosesan batch atau ketika Anda memerlukan respons lengkap sebelum melanjutkan. API kami mendukung kedua mode melalui stream parameter dalam badan permintaan.
Kesalahan Mode JSON
Mode JSON memastikan model mengeluarkan JSON yang valid, yang kritis untuk integrasi pemrograman. Kesalahan di sini sering berasal dari header yang salah atau ketidaksesuaian skema. API memerlukan response_format: {"type": "json_object"} untuk memaksakan output JSON yang ketat.
Jika Anda menerima JSON yang tidak valid, periksa definisi skema Anda. Model mungkin menyertakan blok kode markdown atau teks penjelasan di luar struktur JSON. Gunakan parser yang kuat yang dapat menghapus pembatas markdown atau memvalidasi output terhadap skema yang Anda harapkan. Hindari skema yang terlalu kompleks yang dapat membingungkan model.
Uji dengan struktur sederhana terlebih dahulu. Tambahkan kompleksitas secara bertahap untuk mengidentifikasi di mana model kesulitan. Pastikan suhu Anda diatur dengan tepat, karena suhu yang lebih tinggi dapat meningkatkan keacakan dan mengurangi validitas JSON.
Kesalahan Hitungan Token
Jumlah token menentukan penagihan dan penggunaan jendela konteks Anda. Perhitungan yang salah dapat menyebabkan biaya yang tidak terduga atau respons yang terpotong. API kami membebankan $0.15 per 1M token input dan $0.50 per 1M token output.
Gunakan pustaka tokenizer andal yang sesuai dengan skema tokenisasi model. Model yang berbeda mungkin men-tokenisasi spasi atau tanda baca secara berbeda, menyebabkan ketidaksesuaian antara hitungan lokal Anda dan hitungan API. Selalu andalkan penggunaan token yang dikembalikan dalam respons untuk penagihan yang akurat.
Perhatikan jendela konteks Anda, yang totalnya adalah 100.000 token. Melebihi batas ini akan menyebabkan kesalahan. Potong pesan atau ringkasan lama agar tetap dalam batas. Pantau penggunaan token Anda seiring waktu untuk mengoptimalkan struktur prompt dan mengurangi biaya.
Penundaan Pembayaran Kripto
Isi ulang kripto melalui USDT (TRC20) atau USDC (Base) diproses secara instan di sisi kami. Namun, kemacetan jaringan terkadang dapat menyebabkan sedikit penundaan konfirmasi. Pastikan Anda mengirim jumlah dan jaringan yang benar untuk menghindari kerugian.
Top-up berkisar antara $20 hingga $500 dalam jumlah bulat. Kredit bonus diterapkan secara otomatis: +5% dari $50, +10% dari $100, dan +15% dari $200. Verifikasi hash transaksi untuk mengonfirmasi pembayaran. Jika kredit tidak muncul dalam beberapa menit, periksa penjelajah blockchain untuk status transaksi.
Kredit tidak pernah kedaluwarsa, sehingga tidak ada urgensi untuk menggunakannya segera. Kesalahan seperti pembebanan ganda diselesaikan melalui halaman Dukungan. Simpan catatan transaksi Anda untuk referensi mudah jika terjadi masalah.
Konfigurasi ID Model
ID model mengidentifikasi versi model uncensored mana yang Anda gunakan. Untuk layanan kami, ID modelnya adalah uncensored. Menggunakan ID yang salah dapat menyebabkan kesalahan atau perilaku yang tidak terduga.
Pastikan permintaan Anda menentukan model: "uncensored" dalam tubuh permintaan. ID ini menunjuk ke model open-weight spesifik kami yang disesuaikan untuk respons tanpa batasan. Ini bukan pengidentifikasi generik tetapi penunjuk spesifik ke instance yang di-host kami.
Periksa dokumentasi pustaka klien Anda untuk cara mengatur ID model. Beberapa pustaka menggunakan model bidang, sementara yang lain mungkin menggunakan parameter berbeda. Konsistensi dalam penggunaan ID model di seluruh aplikasi Anda mencegah kebingungan dan memastikan Anda selalu memanggil model uncensored yang dimaksud.
Pelanggaran Jendela Konteks
Jendela konteks membatasi jumlah total token yang dapat Anda kirim dalam satu permintaan. API kami mendukung jendela 100.000 token, termasuk prompt dan completion. Melebihi batas ini akan menghasilkan error.
Untuk mengelola konteks, terapkan strategi jendela geser. Hapus pesan yang lebih lama atau ringkas untuk mengosongkan ruang. Pantau jumlah token input Anda untuk memastikan tetap dalam batas 100.000 token. Jika Anda melebihi batas, API akan menolak permintaan.
Gunakan max_tokens parameter untuk mengontrol panjang output. Output maksimum per permintaan adalah 16.000 token. Menetapkan parameter ini membantu mencegah penggunaan token yang berlebihan dan menjaga respons tetap dalam batas yang dapat dikelola untuk aplikasi Anda.
Kebijakan Dukungan dan Pengembalian Dana
Kredit tidak dikembalikan setelah digunakan, tetapi tidak pernah kedaluwarsa. Jika Anda mengalami masalah dengan pembayaran atau layanan, hubungi Dukungan melalui halaman yang ditunjuk. Kesalahan seperti pembebanan ganda diselesaikan oleh tim Dukungan.
Untuk masalah teknis, periksa dokumentasi terlebih dahulu. API kami mudah digunakan, tetapi kasus tepi mungkin muncul. Berikan kunci API dan detail permintaan saat mencari bantuan. Waktu respons bervariasi, tetapi kami bertujuan untuk menyelesaikan masalah dengan cepat.
Ingat bahwa kredit adalah prabayar. Anda membayar apa yang Anda konsumsi, dengan kesalahan dan penolakan gratis. Model ini memastikan transparansi dalam penagihan. Gunakan halaman Dukungan untuk ketidaksesuaian atau pertanyaan tentang akun Anda.
