menggunakan base_url yang salah
Menggunakan URL dasar OpenAI standar menyebabkan permintaan Anda gagal atau dialihkan ke model yang sama sekali berbeda. API kami mengharuskan Anda mengubah base_url ke https://api.whatisopenrouterai.com/v1. Satu baris konfigurasi ini memastikan SDK Anda terhubung ke server kami alih-alih infrastruktur OpenAI global.
Banyak pengembang menyalin-tempel kode yang ada tanpa memperbarui variabel ini. Jika Anda meninggalkan URL default, Anda akan mendapatkan kesalahan 404 atau mencapai model yang tidak tanpa sensor. Selalu verifikasi koneksi dengan memeriksa /v1/models endpoint. Anda harus melihat ID model spesifik kami terdaftar di sana. Ini mengkonfirmasi bahwa pengalihan rute benar sebelum Anda mengirim permintaan penyelesaian pertama Anda.
melupakan untuk mengatur id model
Meski dengan URL dasar yang benar, mengabaikan ID model akan secara default ke model generik atau lama. Anda harus secara eksplisit mengatur model parameter ke "uncensored" dalam setiap permintaan. Ini memberi tahu lapisan routing kami untuk melayani model open-weight spesifik yang disesuaikan untuk konten tanpa batasan.
Tanpa instruksi eksplisit ini, Anda mungkin menerima model lain dengan aturan penyesuaian yang berbeda. Beberapa model menolak topik dewasa yang sah secara default. Dengan memaksa uncensored ID, Anda menjamin perilaku yang Anda harapkan. Periksa kode Anda untuk nama model yang dikodekan secara hardcode yang mungkin mengesampingkan pengaturan default SDK Anda.
mengabaikan batas token dan kesalahan
Melebihi jendela konteks 100.000 token atau batas output 16.000 token menyebabkan kegagalan permintaan segera. API kami memberlakukan output maksimum 16.000 token per permintaan. Jika Anda tidak mengatur max_tokens, nilai defaultnya hanya 2.048 token. Ini sering kali terlalu pendek untuk tugas penalaran kompleks.
Kesalahan dan penolakan tidak menguras kredit prabayar Anda. Namun, permintaan yang tidak valid yang memukul batas laju atau melebihi ukuran badan (8 MB) masih dihitung terhadap kuota Anda. Pantau header respons Anda untuk penggunaan token. Sesuaikan rekayasa prompt Anda agar sesuai dengan jendela konteks. Ini mencegah retry yang mahal dan memastikan aliran data yang lancar.
kesalahan memahami penagihan pra-bayar
Saldo akun Anda terkait dengan kredit prabayar, bukan langganan bulanan. Kami mengenakan biaya $0.15 per 1M token input dan $0.50 per 1M token output. Kesalahan gratis, tetapi penyelesaian yang berhasil mengonsumsi kredit. Anda harus mengisi ulang melalui kripto untuk menjaga ketersediaan layanan.
Kami menerima USDT (TRC20) atau USDC (Base) untuk pengisian saldo. Deposit minimum dimulai dari $20. Bonus berlaku di tier yang lebih tinggi: +5% dari $50, +10% dari $100, dan +15% dari $200. Kredit tidak pernah kedaluwarsa. Pastikan saldo Anda positif sebelum menjalankan batch besar. Periksa dasbor untuk memverifikasi saldo saat ini dan transaksi terbaru.
mengacaukan streaming dengan respons standar
Streaming via SSE mengubah cara Anda mem-parsing stream respons. Respons standar mengembalikan satu objek JSON. Streaming mengembalikan beberapa chunk. Anda harus menangani chunk terakhir untuk mendapatkan statistik penggunaan token yang akurat.
Implementasi streaming kami mencakup penggunaan token dalam potongan terakhir. Jika Anda menghentikan pembacaan stream lebih awal, Anda mungkin melewatkan data ini. Pastikan pustaka klien Anda mendukung SSE dengan benar. Ini sangat penting untuk aplikasi real-time di mana Anda menampilkan token saat dihasilkan. Streaming yang salah konfigurasi dapat menyebabkan teks tidak lengkap atau status UI yang rusak.
kesalahan konfigurasi tool_choice
Salah tool_choice pengaturan dapat mencegah pemanggilan fungsi bekerja seperti yang dimaksud. Anda dapat memaksa alat tertentu atau membiarkan model memutuskan. Konfigurasi yang salah sering kali menyebabkan model mengabaikan fungsi yang tersedia.
Gunakan tool_choice untuk mengontrol apakah model memanggil alat secara otomatis. Atur ke "auto" untuk fleksibilitas atau tentukan ID alat untuk perilaku ketat. Pastikan definisi fungsi Anda sesuai dengan skema yang diharapkan. Ini menghindari kesalahan runtime ketika model mencoba memanggil fungsi yang tidak ada. Uji definisi alat Anda secara menyeluruh sebelum menerapkannya ke produksi.
mode json_object hilang
Tanpa response_format: {"type": "json_object"}, model mungkin menghasilkan markdown atau teks biasa. Ini merusak parser yang mengharapkan JSON ketat. Aktifkan mode JSON untuk memastikan output yang konsisten dan dapat diuraikan.
Fitur ini sangat penting untuk integrasi dengan sistem turunan yang memerlukan data terstruktur. Ini secara signifikan mengurangi overhead pasca-pemrosesan. Selalu validasi skema output di kode klien Anda. Ini memastikan ketahanan terhadap halusinasi model sesekali. Gunakan mode ini saat mengekstrak entitas atau menghasilkan file konfigurasi.
kejutan batas laju
API kami mengizinkan 300 permintaan per menit per kunci. Melebihi batas ini menghasilkan respons 429 Too Many Errors. Permintaan bersamaan dibatasi hingga 8 per kunci. Atur pengaturan konkurensi Anda dengan tepat.
Jika Anda menjalankan beberapa proses, pastikan mereka berbagi kunci yang sama atau buat kunci terpisah. Setiap akun mendukung satu kunci aktif. Kunci baru menggantikan kunci lama. Pantau header batas laju Anda dalam respons. Terapkan backoff eksponensial dalam logika percobaan ulang Anda. Ini mencegah kegagalan beruntuan selama periode lalu lintas tinggi.
penundaan pengisian ulang kripto
Transaksi kripto mungkin memerlukan waktu untuk dikonfirmasi di blockchain. Kredit Anda mungkin tidak muncul segera setelah mengirim dana. Gunakan jaringan yang benar: TRC20 untuk USDT atau Base untuk USDC. Mengirim ke jaringan yang salah menyebabkan kehilangan dana.
Top-up berkisar dari $20 hingga $500. Pastikan Anda mengirim jumlah yang tepat atau memperhitungkan biaya jaringan. Periksa hash transaksi di penjelajah blockchain. Jika kredit tertunda, hubungi dukungan dengan ID transaksi. Jangan mengasumsikan pembayaran gagal segera. Kesabaran saat kemacetan jaringan adalah kunci untuk operasi yang lancar.
